错误处理

请求到达 API 层后，错误通常返回 JSON。网络、CDN 或二进制传输中断可能没有相同的响应体，客户端需要同时处理 API 错误和传输错误。

{
  "code": "invalid_request",
  "message": "请求参数无效。",
  "requestId": "req_xxx"
}

状态码

建议记录接口、HTTP 方法、状态码、code、requestId 和自己的业务任务 ID。异步请求还应记录 API 返回的任务 ID，用于恢复查询和核对计费。

可对 429 和部分 500 使用退避重试。不要直接重试 400、401 或 402。创建类请求如果没有收到响应，应先使用任务列表或任务详情确认原请求是否已被接受。

HTTP 状态码本身不能完整说明计费结果。处理客户账单问题时，应结合任务状态和最新的账户与余额进行核对。