> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# 错误码与排查

<h2 id="error-response-format">
  错误响应格式
</h2>

```json
{
  "code": 1003,
  "message": "Invalid token",
  "requestId": "req-12345678"
}
```

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

<h2 id="common-error-codes">
  常用错误码
</h2>

| 错误码             | 说明                  |
| --------------- | ------------------- |
| `0`             | 成功                  |
| `1001`          | 未提供有效鉴权信息           |
| `1002`          | Token 已过期           |
| `1003`          | Token、API Key 或签名无效 |
| `1004`          | Token 已被撤销          |
| `1006`          | 来源 IP 不匹配           |
| `2001`          | 缺少必填参数              |
| `2002`          | 参数值无效               |
| `2003`          | 参数超出范围              |
| `3001`          | 余额不足                |
| `3003`          | 订单不存在               |
| `3004`          | 重复请求                |
| `3005`          | 订单不可撤销              |
| `3006`          | 无权限访问               |
| `3100` - `3112` | 条件单参数校验错误           |
| `5001`          | 服务内部错误              |
| `5002`          | 服务暂不可用              |
| `5003`          | 触发限流                |

<h2 id="troubleshooting">
  排查建议
</h2>

| 问题                                      | 建议                                                          |
| --------------------------------------- | ----------------------------------------------------------- |
| `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` 校准时间偏移后重新签名。                                  |