返回适当的状态代码
为每个响应返回适当的 HTTP 状态代码。成功的响应应根据本指南进行编码:
200
:请求成功了GET
,POST
,DELETE
,或PATCH
调用同步完成,或PUT
调用同步更新现有资源201
:请求成功POST
,或PUT
同步创建新资源的调用。提供指向新创建资源的"位置"标头也是最佳实践。 这在POST上下文中特别有用,因为新资源将具有与原始请求不同的 URL202
:接受请求的POST
,PUT
,DELETE
,或PATCH
通话将被异步处理206
:请求成功GET
,但只返回了部分响应:见上面的范围
注意认证和授权错误码的使用:
401 Unauthorized
:请求失败,因为用户未通过身份验证403 Forbidden
:请求失败,因为用户无权访问特定资源
出现错误时返回合适的代码以提供附加信息:
422 Unprocessable Entity
:您的请求已被理解,但包含无效参数429 Too Many Requests
: 你被限速了,稍后重试500 Internal Server Error
:服务器出现问题,检查状态站点和/或报告问题
有关用户错误和服务器错误情况的状态代码的指导,请参阅HTTP 响应代码规范 。