为每一次的响应返回合适的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