饿了么开放平台API调用协议错误对象
当接口调用成功时,error对象为null,反之当发成异常时,error对象不为null。
开发者可根据error对象是否为null以此判断接口调用结果。
error对象结构如下:
keyTypeDescription
codeString错误码,参阅下方4.2.2错误码
messageString错误原因具体描述
错误码:
一个API调用可能会返回两种错误码,一种是通用的错误码,一种是业务错误码,具体区别如下:
通用错误码:例如权限不足,超过访问频次等错误信息,每个接口都会有的固定的错误码
业务错误码:每个接口特有的业务错误码,通过错误码可以得到接口业务异常信息,业务错误码可以在接口文档上查阅
通用错误码说明:
通用错误码错误说明如何解决
ILLEGAL_REQUEST无效请求,请求协议不对使用SDK辅助开发或者根据文档协议将请求体修改正确
UNAUTHORIZEDtoken认证失败检查token是否失效,刷新或者重新获取token
ACCESS_DENIED拒绝访问,一般是应用未上线,不允许访问生产环境资源完成应用开发后提交应用进行审核
METHOD_NOT_ALLOWED禁止访问,一般是没有访问接口/数据的权限检查请求的接口参数是否正确
PERMISSION_DENIED越权访问一般是获取非商户可管理的店铺/订单等资源,检查请求参数是否正确
EXCEED_LIMIT超出接口访问的频次限制优化程序,使用合理的频次访问开放平台的接口
INVALID_SIGNATURE签名错误使用SDK进行签名计算或者检查签名算法,尤其注意检查参数名、参数类型是否跟文档标识一致
INVALID_TIMESTAMP时间戳异常检查请求访问时的时间是否无误
VALIDATION_FAILED参数校验失败检查参数值、参数名、参数类型是否正确
SERVER_ERROR系统问题,API服务器异常请稍后重试