异常处理

异常处理

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

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

• 当 HTTP 状态码为 4xx（请求错误）时，这些状态代码表示请求可能出错，妨碍了服务器的处理，此时应检查客户端配置和代码。

• 当 HTTP 状态码为 5xx（服务器错误）时，这些状态代码表示服务器在尝试处理请求时发生内部错误，此时应通知运维人员对服务端进行检查。

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

---

常见的 HTTP 状态码及其含义

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