为每一次的响应返回合适的HTTP状态码。 好的响应应该使用如下的状态码:
200
:GET
请求成功,及DELETE
或PATCH
同步请求完成,或者PUT
同步更新一个已存在的资源201
:POST
同步请求完成,或者PUT
同步创建一个新的资源202
:POST
,PUT
,DELETE
,或PATCH
请求接收,将被异步处理206
:GET
请求成功,但是只返回一部分
使用身份认证(authentication)和授权(authorization)错误码时需要注意:
401 Unauthorized
: 用户未认证,请求失败403 Forbidden
: 用户无权限访问该资源,请求失败
当用户请求错误时,提供合适的状态码可以提供额外的信息:
422 Unprocessable Entity
: 请求被服务器正确解析,但是包含无效字段429 Too Many Requests
: 因为访问频繁,你已经被限制访问,稍后重试500 Internal Server Error
: 服务器错误,确认状态并报告问题
对于用户错误和服务器错误情况状态码,参考: HTTP response code spec