Skip to main content

错误码

API 错误响应与处理建议

HTTP 状态码

状态码含义处理建议
200成功—
400请求参数错误校对参数
401鉴权失败检查 API Key
403无权限申请对应权限
404资源不存在校对 ID
429限流退避重试
500服务内部错误重试

错误响应结构

{
  "code": "InvalidParameter",
  "message": "user_id is required",
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

重试策略

错误类型是否重试间隔
4xx（限流除外）否—
429 限流是1s/2s/4s 指数退避
5xx是1s/2s/4s，最多 3 次

排错

每个响应都带 request_id，可用于快速定位日志。
限流规则参见限流说明。