平台简介
欢迎使用秋晚权益开放平台API！
秋晚权益是专业的数字权益服务平台，提供各类数字商品、会员卡券、充值服务等一站式解决方案。通过我们的API接口，您可以快速接入平台，实现商品查询、订单管理、售后处理等功能。
平台特色
- 品类丰富：覆盖视频会员、音乐会员、餐饮券、生活服务等500+数字商品
- 价格优势：直连官方渠道，享受最优采购价格
- 稳定可靠：99.9%系统可用性，7x24小时技术支持
- 快速到账：秒级充值到账，支持批量下单
- 安全保障：多重签名验证，确保交易安全
接入流程
- 注册成为秋晚权益平台用户
- 开通分站/代理权限
- 获取API密钥（用户ID + 用户密钥）
- 阅读接口文档，进行接口对接
- 联调测试，正式上线
签名规范
重要提示：所有API请求都需要进行签名验证，确保请求的合法性和安全性。
签名算法
使用MD5签名算法，按照以下步骤生成签名：
- 将所有请求参数（除sign外）按照参数名ASCII码从小到大排序
- 将排序后的参数以 key=value 的格式用 & 连接
- 在字符串末尾拼接 &key=用户密钥
- 对最终字符串进行MD5加密，得到32位小写字符串即为sign值
签名示例
PHP
// 示例参数
$params = [
'user_id' => '10001',
'goods_id' => '100',
'mobile' => '13800138000',
'out_trade_no' => 'ORDER202311100001',
'timestamp' => '1699584000',
];
// 1. 按照参数名ASCII码从小到大排序
ksort($params);
// 2. 拼接参数
$signStr = '';
foreach ($params as $key => $value) {
$signStr .= $key . '=' . $value . '&';
}
// 3. 拼接密钥
$signStr .= 'key=您的用户密钥';
// 4. MD5加密
$sign = md5($signStr);
echo $sign; // 输出32位小写签名
全局状态码
所有接口返回统一的状态码格式，以下是全局通用状态码：
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 参数错误 |
| 401 | 签名验证失败 |
| 403 | 权限不足 |
| 404 | 资源不存在 |
| 500 | 服务器内部错误 |
| 1001 | 用户不存在 |
| 1002 | 余额不足 |
| 1003 | 商品不存在 |
| 1004 | 商品已下架 |
| 1005 | 订单不存在 |
| 1006 | 订单状态异常 |
用户余额查询
GET 查询用户当前余额信息
请求地址
/api/user/balance
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
| timestamp | int | 是 | 当前时间戳（10位） |
| sign | string | 是 | 请求签名 |
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200表示成功 |
| msg | string | 返回消息 |
| data.balance | float | 用户余额 |
| data.frozen_balance | float | 冻结余额 |
| data.available_balance | float | 可用余额 |
商品分类列表
GET 获取平台商品分类列表
请求地址
/api/goods/cate
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
| timestamp | int | 是 | 当前时间戳 |
| sign | string | 是 | 请求签名 |
商品列表接口
GET 获取指定分类下的商品列表
请求地址
/api/goods/list
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
| cate_id | int | 否 | 分类ID，不传返回全部 |
| page | int | 否 | 页码，默认1 |
| page_size | int | 否 | 每页数量，默认20 |
| timestamp | int | 是 | 当前时间戳 |
| sign | string | 是 | 请求签名 |
商品详情接口
GET 获取单个商品的详细信息
请求地址
/api/goods/info
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
| goods_id | int | 是 | 商品ID |
| timestamp | int | 是 | 当前时间戳 |
| sign | string | 是 | 请求签名 |
商品调价记录
GET 获取商品价格变动历史记录
请求地址
/api/goods/price-log
商品变更通知
POST 商品信息变更时的异步通知
商品下单模板
获取指定商品的下单模板信息
订单提交接口
POST 提交订单进行购买
请求地址
/api/order/buy
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户ID |
| goods_id | int | 是 | 商品ID |
| mobile | string | 否 | 充值手机号（充值类商品必填） |
| account | string | 否 | 充值账号（账号类商品必填） |
| out_trade_no | string | 是 | 商户订单号（唯一） |
| notify_url | string | 否 | 异步回调地址 |
| quantity | int | 否 | 购买数量，默认1 |
| timestamp | int | 是 | 当前时间戳 |
| sign | string | 是 | 请求签名 |
订单查询接口
GET 查询订单详情
请求地址
/api/order/info
订单异步回调
POST 订单状态变更时的异步通知
订单撤单接口
POST 申请撤销订单
售后申请接口
POST 提交售后申请
售后处理回调
POST 售后处理结果异步通知
获取订单接口
后台管理 - 获取订单列表
处理订单接口
后台管理 - 处理订单（充值/补发等）
用户加款接口
后台管理 - 给用户余额加款
售后列表接口
后台管理 - 获取售后申请列表
售后详情接口
后台管理 - 获取售后申请详情
售后处理接口
后台管理 - 处理售后申请
商家订单列表
供货商 - 获取订单列表
商家订单详情
供货商 - 获取订单详情
商家订单处理
供货商 - 处理订单
商家售后列表
供货商 - 获取售后申请列表
商家售后详情
供货商 - 获取售后申请详情
商家售后处理
供货商 - 处理售后申请