异常处理

异常处理

请先阅读本文档下有关响应结果的章节。

如果接口调用失败,将会在 HTTP 状态码中得到体现,通常可分为两种类型:

同时,响应结果中的 errcode 字段的值会是 5 位整数,其中前 3 位与 HTTP 状态码相同。该值描述了当前异常可能的原因。


常见的 HTTP 状态码及其含义

HTTP 状态码含义
400 BadRequest非法请求。通常原因是请求携带的参数或查询字符串错误。
401 Unauthorized请求未授权。通常原因是请求签名错误或授权令牌无效。
403 Forbidden请求被阻止。通常原因是不被允许访问请求的对象。
404 NotFound对象未找到。通常原因是请求的对象不存在或已被删除。
405 NotAllowed请求不被允许。通常原因是请求路由不正确。
408 Timeout请求超时。通常原因是请求中携带的时间戳信息错误。
429 QuotaExceed请求配额超限。通常原因是请求过于频繁。
500 InternalServerError服务器遇到了内部错误。