下面是两类错误码的对照表,开发者在使用京东API时遇到错误提示可以对照表格找到问题所在以及解决方案。
一. 网关系统错误码
这种错误一般是由于用户的请求不符合各种基本校验而引起的。用户遇到这些错误的返回首先检查应用的权限、频率等情况,然后参照文档检验一下传入的参数是否完整且合法。
错误码 | 错误中文描述 | 错误英文描述 | 解决方案 |
2 | 限制时间内调用失败次数 | App Call Limited | 1.调整程序合理调用API,请隔日再调用? 2.请将您的appkey发送至jos@jd.com或提交工单,要求提升流量(请提供一下您的商家id、商品数量及日订单量,以便我们核实您的调用量) 3.您可经常登录jos.jd.com,在应用管理中查看您应用的日调用次数,当持续接近调用次数时,请您及时进行处理 |
4 | 缺少版本参数 | Missing Version | 传入的参数加入v字段(API协议版本号) |
5 | 不支持的版本号 | Unsupported Version | 用户传入的版本号没有被提供,即您的版本号不属于目前京东正在使用的版本号 |
7 | 缺少时间戳参数 | Missing Timestamp | 传入的参数中必须包含timestamp参数 |
8 | 非法的时间戳参数 | Invalid Timestamp | 时间戳,格式为yyyy-mm-dd hh:mm:ss,例如:2008-01-25 20:23:30。京东API服务端允许客户端请求时间误差为6分钟。 |
11 | 缺少签名参数 | Missing Signature | 传入的参数中必须包含sign字段,请参考https://jos.jd.com/commondoc?listId=33 |
12 | 无效签名 | Invalid Signature | 签名必须根据正确的算法算出来的, 算法请见https://jos.jd.com/commondoc?listId=33 |
14 | 缺少方法名参数 | Missing Method | 传入的参数中必须包含method参数,即您需要调用的接口名 |
15 | 不存在的方法名 | Invalid Method | 传入的method字段必须是你所调用的API的名称,并且该API名称是确实存在的。某些接口(如无线买家应用、CPS应用)在沙箱中未部署,因此在沙箱中会报此错误 |
18 | 缺少access_token参数 | Missing access_token | 传入的参数中必须包含access_token字段 |
19 | 无效access_token | Invalid access_token | 您传入的token不正确,请确认您的token值与您使用商家账号和appkey应用获取到的token参数一致。 access_token获取方式请见:授权获取token acess_token刷新方式:token过期处置 |
20 | 缺少app_key参数 | Missing app_key | 传入的参数中必须包含app_key字段 |
21 | 无效app_key | Invalid app_key | 所选的appkey必须是正式环境的,而非沙箱环境的appkey |
24 | 无权调用API | cannot use this API | 1.接口无调用权限,请联系京东运营,走http://xbp.jd.com/22/apply/3059宙斯接口上线&应用审核接口权限申请(内部系统,只能京东侧人员申请) |
28 | 接口已停用 | suspend api | 接口已停用 |
43 | 系统处理错误 | system error | 将问题和请求参数发送到jos@jd.com |
二. 网关系统子错误码
这种错误一般是由于服务端(服务提供者)异常引起的。用户遇到这类错误需要隔一段时间再重试就可以解决。
错误码 | 错误中文描述 | 错误英文描述 |
61 | 参数{0}值不合法,请参照帮助文档确认! | parameter {0} is not valid ,please refer to the help document and confirm |
62 | json转换时错误,错误的请求参数 | Missing Version |
63 | json格式不合法 | json格式不合法 |
64 | 此类型商家无权调用本接口 | this type of businesses have no right to call this interface |
65 | 平台连接后端服务超时 | platform connecting service timeout |
66 | 平台连接后端服务不可用 | platform to connect to the back-end service not available |
67 | 平台连接后端服务处理过程中出现未知异常信息 | platform connecting service process unknown exception information |
68 | 验证可选字段异常信息 | validation of optional field anomaly information |
69 | 获取数据失败 | failed to get data |
70 | 该订单正在出库中 | missing order out storage |
71 | 当前的ID不属于此商家 | Id is not belong to the special vender |
72 | 当前的用户不是此类型(如FBP, SOP等)的商家 | The current user is not the type of businesses (FBP, SOP, etc.) |
73 | 该api是增值api,请将您的app入住云鼎平台方可调用 | this api is increased in value;if you want to visit,please put your app on our Cloud platform |
74 | 获取调用这ip失败 | Get the call IP failed. |
75 | 非法的调用这ip | Illegal calling this IP |
77 | 非法的http协议 | Illegal HTTP protocol |
78 | HTTP 调用异常 | http call exception |
79 | 该商家没有权限通过该appKey调用该api | The merchant has no authority to invoke the API through the appKey |
80 | 调用的IP不在APP设置的IP白名单中 | The IP of the call is not in the white list of IP set by APP. |
83 | 该api是解密api,所传参数不包含密文参数 | The API is decrypted API, and the passed parameters do not contain ciphertext parameters |
85 | 解密失败 | Decryption failure |
86 | 后台没有配置接口解密参数 | The background does not configure interface decryption parameters |
87 | 解密字段不是由改appKey所获取的,请使用正确的appkey调用 | The decryption field is not obtained by changing appKey. Please use the correct appkey call |
88 | 没有调用该接口权限,请到“控制中心”->"应用管理“->“接口管理”进行申请 | No access to this interface is allowed. Please apply to dev.jd.com. |
89 | 非法appkey | Illege appKey |
90 | 被监控为非法商家 | Be monitored as illegal business |
91 | 京东pin被监测为非法 | Jingdong pin was detected illegal |
92 | App在测试状态已超过三个月,需要上线后才能继续调用 | App has been testing for more than three months and needs to be online before continuing to call |