随着互联网的发展，越来越多的应用程序以 RESTful API 作为后台接口，而错误信息处理是 API 设计的重要一环。本文将介绍 RESTful API 中错误代码的标识及处理规则，以及一些示例代码。
错误代码的标识
RESTful API 中错误代码的标识通常是 HTTP 状态码，常见的错误状态码有以下几种：
- 200 OK：表示请求成功
- 201 Created：表示新资源已经被创建
- 204 No Content：表示已经成功处理了请求，但是返回的响应中没有实体的主体部分
- 400 Bad Request：表示客户端发送的请求不符合服务器的要求或不合法
- 401 Unauthorized：表示需要认证或用户登录失败，或者没有权限访问该资源
- 403 Forbidden：表示在认证的情况下访问了不被允许的资源
- 404 Not Found：表示请求的资源不存在
- 405 Method not allowed：表示请求方法不被允许
- 500 Internal Server Error：表示服务器出现了错误无法完成响应
除了上述常见的状态码，还有一些状态码也被广泛应用到 RESTful API 服务中，例如：
- 422 Unprocessable Entity：表示请求格式正确，但是由于含有语义错误，无法响应
- 429 Too Many Requests：表示客户端访问频率超过了限制
- 503 Service Unavailable：表示服务器当前无法处理请求，通常是由于维护或者过载而导致
错误代码的处理规则
当发生错误时，API 服务会返回对应的错误码和错误信息，下面是一些处理错误代码的规则：
1. 明确的错误信息
API 服务返回的错误信息应该清晰且简洁，让用户能够明确了解错误信息，从而有针对性的对错误进行处理。
2. 相关联的请求信息
API 返回错误信息时，应该包含相关联的请求信息，例如 URL，方法，请求头等等，这样能够帮助用户更好的理解错误信息。
3. 根据状态码进行处理
根据不同的状态码，应该分别进行处理。例如，在 400 错误状态码时，应该清晰地告知客户端请求错误的具体原因。
4. 提供可处理的错误信息
在 API 返回错误信息时，应该向用户提供可处理的解决方案或建议，从而让用户更好地处理错误。
示例代码
下面是一段 API 返回错误信息的示例代码：
-- -------------------- ---- -------
-
-------- -
------- ----
---------- ---- ---------
---------- -
-
-------- --------
-------- -------- -------
-
-
-
-在该示例代码中，API 返回了 400 错误状态码，并提供了详细的错误信息，包括错误代码，错误原因以及错误细节。同时也包含了请求错误的相关信息以及可处理的错误方案。
结论
RESTful API 中错误代码的标识及处理规则是 API 设计中不可忽略的部分。在设计 API 时，需要考虑到错误处理，以及如何向用户提供清晰简洁的错误信息，从而帮助用户更好的处理错误。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6715acbfad1e889fe218622b