Skip to main content

错误码

Security API 错误响应与处理建议

调用出错时，服务返回如下结构的错误响应，request_id 与响应头 x-request-id 一致： 
{
  "type": "error",
  "error": {
    "code": "405",
    "message": "请求方法不支持"
  },
  "request_id": "82a2ff07-d30f-9905-b9d3-fa2d1c122e01"
}
常见错误码：
codeHTTP 状态码说明
405405请求方法不支持
400400参数校验失败，message 给出具体原因（如 参数类型错误: page_size）
InvalidApiKey401未携带或 API Key 无效（网关层）
Endpoint.AccessDenied403工作空间不存在或无权限（网关层）
BadRequest.IllegalEndpoint400工作空间路由无效（网关层）
鉴权与工作空间路由类错误由网关直接返回，响应结构为扁平的 {"request_id", "code", "message"}；业务错误由服务返回，error.code 为业务错误码。
常见 HTTP 状态码含义如下：
HTTP 状态码说明
400参数缺失、格式错误、超出取值范围
401API Key 无效
403工作空间无权限
404资源不存在
405请求方法不支持
500服务内部异常
排查问题时，可使用 request_id 定位具体请求；错误排除后，对照概览的接口说明继续调用。