什么是 RESTful API ？
REST（Representational State Transfer）是一种 Web 架构风格，它最初是由 Roy Fielding 在其博士论文中提出，用于描述 Web 应用程序与服务器之间的通信模式。RESTful API 是基于 REST 风格的 API，它是一种 Web 数据交互方式，其依据 HTTP 协议的规定来设计和实现。
RESTful API 是一种灵活和强大的 Web 数据交互方式，它能够满足客户端和服务器之间的各种需求。它强调使用统一标准的接口来达到互操作性，并使用 HTTP 方法处理资源的 CRUD 操作。
什么是幂等性？
幂等性是指对同一个接口的多次请求所产生的副作用都是一致的，即无论请求多少次，在服务端产生的效果都是相同的。在 RESTful API 中，幂等性是指在同一个资源上进行一系列操作时，最终对该资源状态的改变都是相同的。
RESTful API 的幂等性要求
在 RESTful API 中，客户端不应该对服务器端状态进行任何假设或默认值。因此，HTTP 的幂等性要求对 RESTful API 来说是很重要的一点，具体要求如下：
一个 API 请求的副作用只能在第一次执行时发生，之后再次执行对资源状态不产生任何影响。
如果请求具有重复执行的可能，则必须包含请求的标识符，以便服务器在重复执行时能够确定是否为同一个请求。
对于处理无法幂等的请求（如 POST 请求），应该设计适当的机制来尽可能减少副作用。
幂等性的示例代码
在 RESTful API 中，GET 和 PUT 方法符合幂等性要求，而 POST 方法则通常不符合幂等性要求。以下是使用 Node.js 实现 RESTful API 的示例代码：
----- ------- - -------------------
----- --- - ----------
----- ----- - ---
-- ------
----------------- ----- ---- -- -
----------------------------
---
-- ------
--------------------- ----- ---- -- -
----- -- - --------------
----- ---- - --------------- -- ------- --- ----
-- ------ -
---------------------------
- ---- -
-------------------------- --- --------
-
---
-- -----
------------------ ----- ---- -- -
----- ---- - ---------
----- -- - --------
-- -- -- ----
----- ----- - -------------------- -- ------- --- ----
-- ------ --- --- -
-------------------------- ------- ---------
- ---- -
-----------------
---------------------------
-
---
-- ----
--------------------- ----- ---- -- -
----- -- - --------------
----- ---- - ---------
-- -- -- ----
----- ----- - -------------------- -- ------- --- ----
-- ------ --- --- -
-------------------------- --- --------
- ---- -
------------ - -----
---------------------------
-
---
-- ----
------------------------ ----- ---- -- -
----- -- - --------------
-- -- -- ----
----- ----- - -------------------- -- ------- --- ----
-- ------ --- --- -
-------------------------- --- --------
- ---- -
------------------- ---
-------------------------- ----------
-
---
---------------- -- -- -
------------------- ------- -- ---- -------
---在上面的示例代码中，GET 和 PUT 方法是幂等的，因为它们的请求没有状态改变的副作用。而 POST 和 DELETE 方法则通常不是幂等的，因为它们的请求可能会改变资源的状态。在实现 POST 和 DELETE 方法时，需要采取适当的措施，以确保不会对资源状态产生意外的影响。
结论
在 RESTful API 中，幂等性是一项非常重要的要求，它能够确保同一个请求的状态改变始终是一致的。在实现 RESTful API 时，需要注意每个 HTTP 方法的幂等性要求，并采取适当的措施以确保其符合要求。
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/670f8f9e5f551281026562b1