错误返回
更新时间：2026-04-30
请求发生错误时通过respone body返回详细错误信息，遵循如下格式：
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | String | 错误码 |
| message | String | 错误描述 |
| requestId | String | 本次请求的requestId |
示例：
JSON
1{
2 "requestId" : "ae2225f7-1c2e-427a-a1ad-5413b762957d",
3 "code" : "NoSuchKey",
4 "message" : "The resource you requested does not exist"
5}API网关转发错误码
| 错误码 | 错误信息 | HTTP状态码 | 含义 | 解决方法 |
|---|---|---|---|---|
| ResourceNotFound | Resource not found. | 404 | API不存在 | 检查请求的方法、路径、参数等是否正确，是否与已发布的API对应。注意，如果API中定义了必选参数，则请求的Header或Query中必须出现该参数。 |
| SignatureEmpty | Signature is empty. | 400 | 签名为空 | 检查请求头中是否包含签名头 |
| SignatureInvalid | Signature is invalid: Signature format is invalid. | 400 | 签名格式错误 | 检查签名格式是否正确 |
| SignatureAppInvalid | Signature is invalid: App authorization failed. | 400 | APP认证失败 | 签名所用AppKey或AppCode不存在 |
| SignatureTimestampInvalid | Signature is invalid: Timestamp is invalid. | 400 | 签名时间戳错误 | 检查签名中的时间戳格式是否正确 |
| SignatureTimestampExpired | Signature is invalid: Timestamp is expired. | 400 | 签名已过期 | 重新计算签名 |
| SignatureMismatch | Signature is invalid: Signature is mismatched. | 400 | 签名不匹配 | 检查签名计算过程是否正确 |
| RequestTimeTooSkewed | The difference between the request time and the server's time is too large. | 403 | 客户端时间与服务器时间相差过多 | 校正客户端时间并重新计算签名 |
| OverRateLimit | Over rate limit. | 429 | 超过流控限制 | 请求超过客户端QPS限制，请等待一段时间后重试 |
| BadGateway | No available backend. | 502 | 无可用后端 | 请求超过后端QPS限制，或后端为不可用状态，请等待一段时间后重试 |
| BadGateway | Failed to call backend. | 502 | 后端未按预期返回响应 | 检查后端是否正常工作，或联系技术支持 |
| GatewayTimeout | Backend timeout. | 504 | 请求后端超时 | 检查后端是否正常工作，或联系技术支持 |
评价此篇文章