错误码说明

更新时间:

错误码根据出错的系统层级分为三类:API 网关层报错业务网关层报错业务应用层报错

  1. API 网关层报错

    • 区分方式:通过 HTTP 状态码判断。任何非 200 状态码都属于 API 网关报错。

    • 常见问题:请求体格式不合法、鉴权失败、熔断等。

  2. 业务网关层报错

    • 区分方式:通过响应体中的 status 字段判断,status 非 10 时表示业务网关报错。

    • 常见问题:调用下游业务系统超时、报错或通用审核失败等。

  3. 业务应用层报错

    • 区分方式:当业务网关的 status 为 20 且 errorCode 为 B_API_ServiceError 时,表示下游业务应用发生错误。

    • 常见问题:此时,subErrCode 和 subErrMessage 将显示下游业务应用的具体错误编码和报错信息。在具体接口文档中会给出该部分报错编码

一个示例:

HTTP/1.1 200 OK          // API 网关错误状态码,200:成功
{
    "status": 10,        // 业务网关状态码,10: 成功,20: 失败
    "apiInvokeId": "i_66c587a7c6fd500028c10e78",
    "data": {
        "taskId": "01j5ssksqndptm3exv751bz0gj",
        "status": "waiting"
    },
    "subErrCode": null,   // 业务应用错误码
    "subErrMessage": null,// 业务应用错误详情
    "errCode": null,      // 业务网关错误码
    "errMessage": null,   // 业务网关错误详情
}

API 网关实例报错码

HTTP 状态码非 200 错误

API网关错误码表(VPC实例)

业务网关错误码

网关状态码(status)

网关错误码(errCode)

错误信息 Message

(errMessage)

20

B_API_ServiceError

服务调用失败,业务网关调用下游服务时服务返回报错

20

B_API_InvokeTimeout

业务网关调用下游服务超时

20

B_API_CauseFlowControl

业务网关层触发限流:{限流内容}

20

B_API_AuditFailed

入参包含敏感内容(网关层统一内容安全拦截)

业务应用错误码

详见各接口