RESTful API 是一种基于 HTTP 协议的应用程序接口设计风格，它通常通过 HTTP 请求来执行对资源的操作。HTTP 状态码是 RESTful API 中非常重要的一部分，它指示了请求的结果。
HTTP 状态码的分类
HTTP 状态码的格式为 HTTP/1.1 {Status Code} {Reason Phrase}，其中，Status Code 是由 3 个数字组成的值，每个值的范围是从 100 到 599。HTTP 状态码被分为 5 类，它们的含义如下：
- 1xx：信息性状态码，表示服务器已经接收到了请求，但需要更多的信息来完成请求。
- 2xx：成功状态码，表示服务器已经成功接收到和理解了请求。
- 3xx：重定向状态码，表示资源的位置已经改变，需要客户端进行额外的操作来定位资源。
- 4xx：客户端错误状态码，表示客户端的请求有误。
- 5xx：服务器错误状态码，表示服务器无法完成客户端的合法请求。
常见的 HTTP 状态码
下面是一些常见的 HTTP 状态码及其含义：
- 200 OK：服务器成功处理了请求。
- 201 Created：新资源已经被服务器创建。
- 202 Accepted：请求已经被服务器接受，但还没有被处理。
- 204 No Content：服务器成功处理了请求，但没有返回任何内容。
- 400 Bad Request：客户端请求中有语法错误或无法满足请求。
- 401 Unauthorized：客户端没有权限访问该资源。
- 403 Forbidden：服务器拒绝执行请求。
- 404 Not Found：服务器无法找到请求的资源。
- 500 Internal Server Error：服务器遇到错误，无法完成请求。
如何正确地使用 HTTP 状态码
正确使用 HTTP 状态码可以让客户端了解请求的结果，使 RESTful API 更加可靠和可用。下面是一些使用 HTTP 状态码的最佳实践：
1. 使用标准的 HTTP 状态码
在 RESTful API 中，应始终使用标准的 HTTP 状态码，这可以提高可读性和可靠性。
2. 使用正确的状态码
每个状态码都有其含义和适用场景，应该根据请求的结果选择正确的状态码。
3. 提供有用的错误消息
当出现错误时，应该提供有用的错误消息，以便客户端更好地理解问题。
4. 不要滥用状态码
使用错误的状态码可能会导致混淆和错误的行为，因此应该避免滥用状态码。
下面是一个使用 HTTP 状态码的示例代码：
-- -------------------- ---- -------
----- ------- - -------------------
----- --- - ----------
------------ ------------- ---- -
---------------------------- ---------
---
--------------------- ------------- ---- -
----- -- - --------------
-- --- --- ---- -
---------------------- --- --- ----- ----- ---- ---
- ---- -
-------------------------- --- --------
-
---
---------------- ---------- -
------------------- -- ------- -- ---- -------
---在上面的代码中，res.status(200)，表示成功地获取了用户的信息；res.status(404)，表示未找到该用户的信息。
总结
HTTP 状态码是 RESTful API 中的重要组成部分，它可以指示客户端请求的结果。正确使用 HTTP 状态码可以提高 RESTful API 的可靠性和可用性，使客户端更好地理解和处理请求的结果。在使用状态码时应遵守最佳实践，提供有用的错误消息，避免滥用状态码。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/647ae2b3968c7c53b0680889