接口认证说明
获取密钥
登录后进入 个人中心 → 接口密钥 获取 AppId 和密钥(AppSecret)。
添加请求头
所有请求需在 Header 中添加:AppId、AppTimestamp、AppToken
计算 Token
使用 SHA1 对拼接字符串加密:
AppToken = sha1(AppId + AppSecret + 请求URI + AppTimestamp)
1. 账户信息
GET /openapi/customer/CustomerAccount/Show
认证方式:需签名认证 · 环境 URL:https://yilesup.top
响应示例(成功)
{
"code": 0,
"message": "",
"data": {
"balance": 88.88,
"name": "用户名"
}
}
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | Integer | 0 表示成功 |
| data.balance | Number | 账户余额 |
| data.name | String | 用户名称 |
2. 商品分类
GET /openapi/customer/Goods/CategoryList
认证方式:需签名认证
响应示例(成功)
{
"code": 0,
"message": "",
"data": [
{ "id": 100, "name": "特惠商品", "parent_id": 0, "weight": 2 }
]
}
3. 商品列表
POST /openapi/customer/Goods/List
Content-Type: application/json · 认证方式:需签名认证
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| goods_category_id | 否 | Integer | 商品分类 ID |
{ "goods_category_id": 100 }
4. 商品信息
POST /openapi/customer/Goods/Show
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| goods_id | 是 | Integer | 商品 ID |
{ "goods_id": 173 }
5. 购买商品
POST /openapi/customer/Goods/Buy
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| goods_id | 是 | Integer | 商品 ID |
| buy_number | 是 | Integer | 购买数量 |
| buy_params | 是 | Object | 购买参数,如授权域名等 |
| customer_order_id | 否 | String | 客户单号(防重复) |
{
"goods_id": 102,
"buy_number": 1,
"buy_params": { "domain": "example.com" },
"customer_order_id": "order-001"
}
错误码说明
| 错误码 | 含义 |
|---|---|
| 0 | 成功 |
| 1 | 业务失败(商品不存在、参数无效等) |
| 100 | 认证失败 |
| 404 | 接口不存在 |