1. 什么是 RESTful API？
RESTful 是一个设计 API 的风格和标准，全称为 Representational State Transfer。在 Web 开发中，RESTful 是一种基于 HTTP 协议的 API 的设计方式，是一种将资源（Resource）作为一种独立的实体来管理的架构风格。
2. 什么是幂等性
在计算机科学中，幂等性（Idempotence）是指将同一个操作执行多次与执行一次的效果完全相同。
在 RESTful API 中，如果同一个请求被执行了多次，它们应该得到相同的结果，这就是幂等性的概念。幂等性在保证 API 的正确性和可靠性方面非常重要。
3. 幂等性的实现
RESTful API 的幂等性可以通过以下技术来实现：
3.1 HTTP 方法的选择
幂等性的实现和 HTTP 方法的选择有关。我们通常会使用 GET 和 POST 方法来获取和提交资源，但是这两种方法不具有幂等性。如果我们需要实现幂等性，可以使用 PUT 和 DELETE 方法来处理资源操作，并且要保证使用相同的请求数据时，得到的结果也是相同的。
3.2 返回值的设计
RESTful API 应该返回正确的状态码和描述信息。 GET 请求应该返回被请求的资源，而 PUT、DELETE 请求应该返回一个成功或失败的状态码。返回了正确的状态码能够帮助客户端正确的处理资源，并且根据状态码能够进行相应的错误处理。
3.3 唯一标识符
每个资源都应该有自己的唯一标识符。在服务器上，每个资源都应该有唯一的 ID，客户端每次请求时也应该带上这个 ID。通过唯一标识符，服务器能够快速的找到要更新或删除的资源。
4. 去重技术
为了避免重复提交数据或资源，我们需要使用去重技术。
4.1 Token bucket 方法
Token bucket 是一种常用的去重技术。在 Token bucket 算法中，我们通过维护一个桶，每隔固定的时间往桶里放一定数量的令牌，而每个请求来的时候需要先取出一个令牌，如果没有令牌的话，请求就会被拒绝。这个机制能够防止客户端的重复请求。
4.2 基于时间戳的去重方法
在客户端发送请求的时候，可以携带一个时间戳参数，服务器接收到请求后，可以根据时间戳参数判断是否为重复请求。这个方法可以在服务端上实现，也可以在客户端上实现。
5. 示例代码
5.1 实现幂等性
--- ------------ -------- ----- ----------- ------------- ---------------- --------------- -- -------- -------- --- --------
在这个示例中，我们使用 PUT 方法更新了一本名为“RESTful API Design”的书籍，如果有另外一个请求使用相同的请求数据，那么得到的结果应该是一样的，这就是幂等性的实现。
5.2 去重技术
5.2.1 Token bucket
----- --------
--- -------------- --- -----------
------- - --
-------------- - ---------
----- ------------
--- -------------- ----------- -------------
--------------- - ----------
---------------- - -----------
----------- - ----------
--------------------- - -----------
--- ----------------
------------- - ------------ - ---------------------- - ----------------
-- ------------- - --
----------- - -------------------- ----------- - -------------------
--------------------- - -----------
-- ----------- - --
----------- -- -
------ ----
-----
------ -----
----- ------------
--- -------------- ------------- -------------
----------------- - ------------
---------------- - -----------
----------- - ------------------------- ------------
--- ---------------- ---------
-- --- ------------------------
------ -----
-----
------ ----5.2.2 基于时间戳的去重方法
----- ----------------
--- -------------- -----------
----------- - ------
-------------------- - --
--- ------------------ ---------
--- - -------------------------------------------------
-- --- -- -------------------- --- -
----------- - ------------------------- - ------------
------ ----
-----
------------------------- - -----------
------ -----6. 结论
幂等性和去重技术是 RESTful API 中非常重要的一部分。幂等性保证了 API 的正确性和可靠性，去重技术则是防止客户端重复提交的重要手段。我们需要在设计和实现 API 时合理运用这些技术，为 API 的正确使用提供保障。
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/6735c6e80bc820c582506b76