Appearance
错误码
4.1 认证类错误码
| 错误码 | HTTP 状态码 | 含义 | 排查建议 |
|---|---|---|---|
| 40101 | 401 | 签名验证失败 | 检查签名算法、app_secret 是否正确;确认 body 和 query 参数与签名时使用的一致 |
| 40102 | 401 | app_key 无效或已禁用 | 确认 app_key 正确且未被禁用 |
| 40103 | 401 | 请求已过期 | 检查服务器时间是否准确,timestamp 与服务器差值不能超过 5 分钟 |
| 40104 | 401 | 重复请求(nonce 重放) | 每次请求必须使用新的随机 nonce |
| 40105 | 401 | IP 不在白名单 | 联系管理员将你的服务器 IP 加入白名单 |
| 40106 | 403 | 接口权限不足 | 确认你的 app_key 已被授权调用该接口 |
| 40107 | 401 | 客户端已过期 | 联系管理员续期 |
| 41301 | 413 | 请求体过大 | 请求体超过 1MB(批量接口 5MB),请缩减 |
| 42901 | 429 | 请求频率超限 | 降低请求频率,或联系管理员提升限额 |
4.2 业务类错误码
| 错误码 | HTTP 状态码 | 含义 |
|---|---|---|
| 200 | 200 | 成功 |
| 400 | 400 | 请求参数错误(具体信息见 message) |
| 404 | 404 | 资源不存在 |
| 409 | 409 | 数据冲突(如重复创建) |
| 500 | 500 | 服务器内部错误 |