jushuitan/open-api-sdk

聚水潭开放平台 PHP SDK

1.3.0 2025-03-17 13:07 UTC

Requires

• php: >=7.1
• ext-json: *
• guzzlehttp/guzzle: ^6.5
• psr/http-client: ^1.0
• psr/http-message: ^1.0

Requires (Dev)

• phpunit/phpunit: ^9.0
• squizlabs/php_codesniffer: ^3.0

MIT

• Jushuitan Developer

README

这是聚水潭开放平台的PHP SDK，提供了简单易用的接口调用方式。

更新日志

v1.3.0

• 更新guzzlehttp/guzzle依赖版本至^6.5

安装

通过Composer安装:

composer require jushuitan/open-api-sdk

基本使用

Yii2框架中使用

1. 在配置文件中添加组件配置：

'components' => [
    'jushuitan' => [
        'class' => 'Jushuitan\OpenSDK\JushuitanComponent',
        'appKey' => 'your-app-key',
        'appSecret' => 'your-app-secret',
    ],
]

1. 使用示例：

// 获取访问令牌
$result = Yii::$app->jushuitan->getAccessToken('authorization-code');

// 刷新访问令牌
$result = Yii::$app->jushuitan->refreshToken('refresh-token');

// 发送API请求
$result = Yii::$app->jushuitan->request('GET', '/open/shops/query', [
    'page_no' => 1,
    'page_size' => 20,
]);

独立使用

$client = new \Jushuitan\OpenSDK\Client('your-app-key', 'your-app-secret');

// 获取访问令牌
$result = $client->getAccessToken('authorization-code');

// 刷新访问令牌
$result = $client->refreshToken('refresh-token');

// 发送API请求
$result = $client->request('GET', '/open/shops/query', [
    'page_no' => 1,
    'page_size' => 20,
]);

版本历史

v1.3.0 (2024-01-10)

• 调整guzzlehttp/guzzle依赖版本至^6.5，提升SDK兼容性
• 优化依赖包管理

v1.0.0 (2024-01-09)

• 首次发布稳定版本
• 实现基础的OAuth认证功能
• 支持API请求和签名生成
• 提供Yii2框架集成支持
• 完善的文档和使用示例

许可证

本项目采用MIT许可证，详情请参见LICENSE文件。