API 接口文档

晓升软件授权系统 开放接口 v1.0

接口根地址:https://yilesup.top

← 返回接口密钥

接口认证说明

获取密钥

登录后进入 个人中心 → 接口密钥 获取 AppId 和密钥(AppSecret)。

添加请求头

所有请求需在 Header 中添加:AppIdAppTimestampAppToken

计算 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": "用户名"
  }
}
参数名类型说明
codeInteger0 表示成功
data.balanceNumber账户余额
data.nameString用户名称

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_idInteger商品分类 ID
{ "goods_category_id": 100 }

4. 商品信息

POST /openapi/customer/Goods/Show

参数名必填类型说明
goods_idInteger商品 ID
{ "goods_id": 173 }

5. 购买商品

POST /openapi/customer/Goods/Buy

参数名必填类型说明
goods_idInteger商品 ID
buy_numberInteger购买数量
buy_paramsObject购买参数,如授权域名等
customer_order_idString客户单号(防重复)
{
  "goods_id": 102,
  "buy_number": 1,
  "buy_params": { "domain": "example.com" },
  "customer_order_id": "order-001"
}

错误码说明

错误码含义
0成功
1业务失败(商品不存在、参数无效等)
100认证失败
404接口不存在