code 字段表达,失败时 data 为 null,request_id 始终返回。0:成功400xx:参数 / Body 相关错误401xx:鉴权失败(未带 / 错误的 Token、签名等)403xx:权限不足(应用禁用、IP 不在白名单、环境不一致等)429xx:限流500xx / 503xx:服务端错误或下游不可用| code | HTTP | 含义 |
|---|---|---|
0 | 200 | 成功 |
40001 | 400 | 读取请求体失败 |
40005 | 413 | 请求体过大 |
40101 | 401 | 缺少 X-App-Key(仅签名链路) |
40102 | 401 | 缺少签名头 X-Timestamp/X-Nonce/X-Sign(仅签名链路) |
40103 | 401 | X-Timestamp 非法(仅签名链路) |
40104 | 401 | 时间戳偏移超限(仅签名链路) |
40105 | 401 | app_key 无效(仅签名链路) |
40106 | 401 | 签名验证失败(仅签名链路) |
40107 | 401 | Nonce 重放(仅签名链路) |
40110 | 401 | 服务端未启用 Bearer Token 鉴权 |
40111 | 401 | Bearer 令牌格式非法 |
40112 | 401 | Bearer 令牌无效 |
40113 | 401 | Bearer 令牌已吊销 |
40114 | 401 | Bearer 令牌已过期 |
40301 | 403 | 应用已禁用 |
40302 | 403 | 令牌环境与当前平台不一致 |
40303 | 403 | 来源 IP 不在白名单 |
40304 | 403 | 该应用未启用 Bearer Token 鉴权 |
40305 | 403 | 该应用未启用签名 鉴权,请使用 Bearer Token |
40201 | 200 | 请求参数不合法 |
40202 | 200 | 请求参数缺失 |
42901 | 429 | 触发 QPS 上限 |
42902 | 429 | 触发日调用量上限 |
50001 | 500 | 服务内部错误 |
50301 | 503 | 防重放服务暂不可用,请稍后重试 |
50401 | 200 | 上游数据源超时 |
{
"code": 40112,
"message": "Bearer 令牌无效",
"data": null,
"request_id": "a1b2c3d4e5f6..."
}业务接口本身的参数校验失败一般使用 40201 / 40202,HTTP 状态仍为200,请通过code字段判断。