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 状态码说明处理建议
12000093503云安全服务异常对应能力暂时不可用,稍后重试
12000094503告警查询失败稍后重试
排查问题时,可使用 request_id 定位具体请求;错误排除后,对照概览的接口说明继续调用。
Managed Agent API
Flow Agent API
Sandbox API
RAG API
长期记忆
ParseX API
Security API
框架集成
Assistant API(下线中)