接口返回码说明
每次调用伙伴云接口时,如果参数错误或者不符合接口逻辑,接口会返回错误提示,开发者可以根据返回码信息调试接口,排查错误。
接口错误统一返回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 | 登录用户被删除 |
不同的业务模块针对不同的逻辑的有不同的错误码,具体错误信息会在业务模块中单独说明。