错误码与排查

错误响应格式

1 {
2   "code": 1003,
3   "message": "Invalid token",
4   "requestId": "req-12345678"
5 }

业务错误通常仍返回统一 JSON 结构，接入方应优先判断 code。鉴权失败类错误可能返回 HTTP 401；限流可能返回 HTTP 429。

问题	建议
`1001` 未提供有效鉴权信息	检查是否携带 `Authorization: Bearer <accessToken>` 或 `X-API-KEY`。
`1002` Token 已过期	刷新 Token 或重新登录后再请求。
`1003` Token、API Key 或签名无效	检查 API Key、签名载荷、请求体 JSON 字符串和 query 参数顺序是否一致。
`1006` 来源 IP 不匹配	检查 API Key 的 IP 白名单配置。
`3004` 重复请求	订单相关路径不要复用同一个签名；重新生成 `timestamp` 和 `signature`。
`5003` 触发限流	降低请求频率，必要时做指数退避和重试。
`Timestamp outside of tolerance window`	调用 `/v1/time` 校准时间偏移后重新签名。