错误处理

API 错误分为两种类型:

  • 客户端错误( Client Errors )
  • 服务端错误( Server Errors )

当 API 请求处理发生错误时,应向调用端返回错误信息。

错误信息包含两部分:

  • HTTP 错误状态码:
状态码 名称 描述
4xx Client Errors 400~4xx,表示请求方原因产生的错误
- 400 Bad Request 请求方输入的参数或者格式不正确
- 401 Unauthorized 请求方未经过身份认证
- 403 Forbidden 请求方没有权限访问
- 404 Not Found 访问的接口或数据不存在
5xx Server Errors 500~5xx,表示服务端原因产生的错误
- 500 Internal Server Error 服务端产生非预期的错误,具体需要看错误代码和描述
- 501 Not Implemented 请求的接口未实现
- 503 Service Unavailable 服务端无法处理请求
  • JSON 格式的错误对象:
{
    "code": "BAD_REQUEST",
    "message": "请输入'name'参数"
}
上一篇:描述文件 下一篇:安全认证

results matching ""

    No results matching ""