一、响应结构
{
"code": 0,
"msg": "",
"data": {}
}
| 字段 | 类型 | 说明 |
|---|
| code | int | 0 表示成功；非 0 为业务错误码 |
| msg | string | 错误说明，成功时通常为空 |
| data | object / array | 业务数据；分页接口为 records、total、size、current、pages |
二、通用错误码
| code | 说明 | 处理建议 |
|---|
| 0 | 成功 | - |
| 60002 | session 不能为空 | 未携带有效凭据，请检查 Authorization 请求头 |
| 60400 | API 权益已过期 | 联系管理员续费或升级会员 |
| 60500 | 密钥格式非法 | 确认密钥为 36 位且以 sk- 开头 |
| 60501 | 密钥不存在 | 密钥可能已删除，请在密钥页面重新创建 |
| 60502 | 密钥已禁用 | 在密钥页面启用，或创建新密钥 |
| 60503 | 密钥已过期 | 创建新密钥或延长有效期 |
| 60504 | 该接口不支持 API Key 访问 | 该接口未开放，请以「接口速览」为准 |
| 60505 | 请求过于频繁 | 降低调用频率，默认上限 10 次/秒 |
| 60506 | 今日调用额度已用完 | 次日 0 点自动重置，或申请提升额度 |
三、排查建议
- 先用「接口速览」确认目标接口在开放范围内。
- 用「查询商品字典版本」这类轻量接口验证密钥是否有效。
- 仍无法解决时，请提供 Tracking ID、请求时间、请求地址和响应内容。
