每次调用伙伴云接口时,如果参数错误或者不符合接口逻辑,接口会返回错误提示,开发者可以根据返回码信息调试接口,排查错误。

接口错误统一返回HTTP状态为 500 的错误响应。 响应体数据为JSON格式。 其中,code 表示接口错误码,message 表示接口错误信息,errors 定位错误信息。错误返回的示例如下:

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

{
  "code": 100,
  "message": "authentication failed",
}


全局返回码说明如下:

返回码 说明
100 授权信息错误,使用错误或过期的ticket
500 请求的接口版本不正确
501 请求的URL不正确
502 缺少接口必需的参数
6700016 登录用户不存在
6700017 登录用户已被禁止登录
6700041 登录用户被删除

不同的业务模块针对不同的逻辑的有不同的错误码,具体错误信息会在业务模块中单独说明。