错误码说明
更新时间:
错误码根据出错的系统层级分为三类:API 网关层报错、业务网关层报错 和 业务应用层报错。
API 网关层报错
区分方式:通过 HTTP 状态码判断。任何非 200 状态码都属于 API 网关报错。
常见问题:请求体格式不合法、鉴权失败、熔断等。
业务网关层报错
区分方式:通过响应体中的 status 字段判断,status 非 10 时表示业务网关报错。
常见问题:调用下游业务系统超时、报错或通用审核失败等。
业务应用层报错
区分方式:当业务网关的 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 错误
业务网关错误码
网关状态码(status) | 网关错误码(errCode) | 错误信息 Message (errMessage) |
20 | B_API_ServiceError | 服务调用失败,业务网关调用下游服务时服务返回报错 |
20 | B_API_InvokeTimeout | 业务网关调用下游服务超时 |
20 | B_API_CauseFlowControl | 业务网关层触发限流:{限流内容} |
20 | B_API_AuditFailed | 入参包含敏感内容(网关层统一内容安全拦截) |
业务应用错误码
详见各接口
该文章对您有帮助吗?