错误码
所有错误都会以 JSON 形式返回,包含 code 与 message 字段:
{
"code": "INVALID_SIGNATURE",
"message": "Request signature did not match expected value"
}
常见错误码
| HTTP | 错误码 | 含义 |
|---|---|---|
| 400 | INVALID_PARAMETER | 请求参数缺失或格式不正确 |
| 401 | INVALID_SIGNATURE | 签名校验失败 |
| 401 | KEY_EXPIRED | API key 已失效 |
| 403 | INSUFFICIENT_PERMISSION | 当前 key 不具备所需的权限范围 |
| 429 | RATE_LIMITED | 已超出该 key 的限流 额度 |
| 500 | INTERNAL_ERROR | 服务器内部异常 —— 可安全重试 |