错误码
所有错误响应均使用标准 JSON 格式。HTTP 状态码与业务 error 字段并行使用。
标准错误响应格式
{
"ok": false,
"error": "unauthorized",
"msg": "API 密钥无效或已过期"
}
HTTP 状态码
| 状态码 | 含义 | 常见原因 |
|---|---|---|
200 | 成功 | — |
400 | 请求错误 | 参数缺失 / 格式错误 |
401 | 未授权 | 密钥错误 / 时间戳过期 |
403 | 禁止访问 | scope 不足 / IP 不允许 |
404 | 不存在 | 订单/钱包未找到 |
429 | 限流 | 超过每分钟速率 |
500 | 服务器错误 | 系统异常，请联系管理员 |
业务错误码
| error 字段 | 说明 |
|---|---|
unauthorized | 鉴权失败 |
forbidden | 权限不足 |
bad_request | 请求参数错误 |
not_found | 资源不存在 |
rate_limited | 请求过于频繁 |
create_failed | 下单失败 |
refund_failed | 退款失败 |