错误码查询

​

错误响应结构

• HTTP 状态码：表示本次请求最终失败类别。
• X-Request-Id：请求追踪 ID。如果客户端未传入，网关会自动生成；失败响应会尽量回传该值。
• error.message：面向调用方的可读错误描述。
• error.type：错误类型。MaaS 网关返回的稳定错误当前固定为 invalid_request_error；上游平台返回的错误类型可能不同。
• error.code：错误码。MaaS 网关会返回稳定 code；上游平台返回的错误可能没有该字段。

{
  "error": {
    "message": "upstream provider credentials unavailable",
    "type": "invalid_request_error",
    "code": "missing_upstream_key"
  }
}

​

错误来源

​

MaaS 网关

​

上游平台错误

• HTTP 状态码：以实际返回值为准。
• 响应体：通常包含平台返回的 error.type、error.code、error.message。
• X-Request-Id：可用于问题排查和日志检索。
• 文档边界：不要把上游平台的所有 type 或 code 当成 MaaS 网关的稳定错误码。

{
  "error": {
    "message": "daily credits exhausted",
    "type": "insufficient_quota"
  }
}

​

推荐排查顺序

1. 先看 HTTP 状态码，确认是 MaaS 网关稳定错误，还是上游平台直接返回的错误。
2. 再记录 X-Request-Id，用于日志检索和工单排查。
3. 如果 error.code 是 missing_upstream_key、invalid_upstream_key_info、masked_upstream_key 之一，可联系平台管理员处理服务配置问题。
4. 如果是上游平台错误，优先根据返回的 error.type、error.code、error.message 判断额度、鉴权或平台策略限制。