API 网关

产品文档

API 网关

帮助中心 > 产品文档 > API 网关 > 调用过程中公共错误码参考

调用过程中公共错误码参考

当您使用SDK经过京东云API网关对API进行调用时,可参考如下的公共错误码信息:

(1)客户端错误

Http 状态码 错误代码 错误信息 语义 解决方案
400 HTTP_BAD_REQUEST the request blocked by security rules 请求被安全规则拦截 参考京东云waf
401 ACCESS_ERROR Invalid authentication credentials 认证凭证不合法 请使用有权限的访问密钥,或联系服务商提供有权限的访问密钥
401 ACCESS_ERROR Invalid accessKey 访问密钥错误 需正确填写访问密钥
401 ACCESS_ERROR lack of header authorization header中缺少authorization信息 如果使用的是订阅密钥访问,确认订阅密钥是否正确。否者使用服务商提供的sdk访问服务
401 ACCESS_ERROR lack of credential in the header authorization authorization中缺少credential 信息 使用服务商提供的sdk访问服务
401 ACCESS_ERROR lack of header x-jdcloud-date header中缺少x-jdcloud-date信息 使用服务商提供的sdk访问服务
401 ACCESS_ERROR lack of header signedHeaders header中缺少signedHeaders信息 使用服务商提供的sdk访问服务
401 ACCESS_ERROR sign result is not same 客户端和网关的签名不一致 检查调用数据有没有被修改,和确认ak,sk填写是否正确
403 HTTP_FORBIDDEN Your IP address is not allowed 当前客户端IP不允许访问服务 联系服务商进行ip权限配置
403 HTTP_FORBIDDEN api is disabled API不可用 该API分组已下线
404 NOT_FOUND no route and no API found with those values 找不到api和路由 该分组没有发布,请确认域名是否使用正确,或联系服务商
413 HTTP_REQUEST_ENTITY_TOO_LARGE Payload too large 请求体太大 请求body超时限制,目前请求body大小限制为100m
414 HTTP_URI_TOO_LONG URI too long 请求url太长 请求url超出限制,目前限制为8k
429 HTTP_RATE_LIMIT_EXCEEDED minute rate limit exceeded, role:ak 因 accessKey流控被限制 调用频率过高导致被流控,可以联系 API 服务商协商放宽限制
429 HTTP_RATE_LIMIT_EXCEEDED minute rate limit exceeded, role:api 因 API 分组流控被限制 调用频率过高导致被流控,可以联系 API 服务商协商放宽限制

(2)服务器端错误

以下为API服务端错误,如果频繁错误,可联系服务商。

Http 状态码 错误代码 错误信息 语义 解决方案
500 HTTP_INTERNAL_SERVER_ERROR An unexpected error occurred 内部错误 建议重试,或者联系服务商
502 HTTP_BAD_GATEWAY An invalid response was received from the upstream server 服务端返回错误 建议重试,或者联系服务商
503 HTTP_SERVICE_UNAVAILABLE The upstream server is currently unavailable 后端服务不可用 建议重试,或者联系服务商
504 HTTP_SERVER_TIMING_OUT The upstream server is timing out 后端服务超时 建议重试,或者联系服务商
更新时间:2020-06-28 15:39:41