公共参数
公共参数
所有 API 请求需包含以下公共参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appKey | string | 是 | 项目 App Key |
| timestamp | number | 是 | 当前时间戳(秒或毫秒),有效窗口 5 分钟 |
| sign | string | 是 | 请求签名 |
响应格式
所有 API 统一返回 JSON 格式:
json
{
"success": true,
"code": 200,
"msg": "OK",
"data": { ... }
}错误时:
json
{
"success": false,
"code": 401,
"msg": "Invalid sign"
}常见错误码
| 错误码 | 说明 |
|---|---|
| 400 | 请求参数错误 |
| 401 | 签名校验失败或请求已过期 |
| 403 | App Secret 未配置 |
| 404 | App Key 无效 |
| 500 | 服务器内部错误 |