错误处理
API错误分为两种类型:
- 客户端错误(Client Errors)
- 服务端错误(Server Errors)
当API发生错误时,应返回错误信息,错误信息包含两部分:
- HTTP错误状态码:
| Status | Name | Description |
|---|---|---|
| 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'参数"
}