接口约定
请求约定
POST 方法提交；所有 Body 参数使用
application/x-www-form-urlencoded 的格式提交；所有接口调用，必须经过签名，签名逻辑见：接口签名。
基础响应结构
{
"success": true, // bool，请求是否被成功处理
"code": "2000", // string，状态码
"message": "", // string，状态消息
"data": null // any，数据体（object/array/string/null）
}分页响应结构
{
"success": true,
"code": "2000",
"message": "",
"data": {
"list": [], // 数据列表
"current_page": 1, // 当前页数（从 1 开始）
"page_count": 10, // 总页数
"has_more": false, // 是否还有更多
"total_count": 95 // 总记录条数
}
}状态码说明
| 状态码 | 状态说明 | 备注 |
|---|---|---|
2000 | 接口处理成功 | 可靠 |
4000 | 客户端请求错误 | message 字段会说明具体原因（参数错误、鉴权失败、签名错误、余额不足、资源不足等） |
注意：状态码为 字符串类型，不是整型。
请求 Header 设计
| Header Key | 是否必填 | 说明 | 值 |
|---|---|---|---|
Content-Type | 是 | 内容编码方式 | application/x-www-form-urlencoded |
签名方法
修改于 2026-07-13 08:25:24