RESTful API 是一种相当流行的 API 设计风格，它使 Web 服务的开发更加简单、灵活和可扩展，并易于理解和使用。其中一个重要的概念是幂等性，它是 RESTful API 中最基本的原则之一。本文将详细介绍什么是幂等性，如何实现 RESTful API 中的幂等性，以及如何防止重复提交。
什么是幂等性？
幂等性指的是，对同一个 RESTful 资源多次进行请求所产生的结果，与对该资源进行一次请求所产生的结果相同。
具体而言，对于任何一个 RESTful API 请求，如果接收到多个相同的请求，那么它们产生的效果应该与只有一个请求所产生的效果一致。
值得注意的是，幂等性并不是要求所有请求返回相同的结果，而是要求所有请求对系统状态产生相同的影响。比如说，查询请求可以返回不同的结果，但是不管你查询多少次，它都不会改变系统状态。
幂等性不仅是 RESTful API 设计的基本原则之一，也是高效可靠且安全的设计实践。
如何实现幂等性？
在 RESTful API 中实现幂等性的关键是唯一标识符。唯一标识符是一个用于标识资源的值，它可以是任意值，只需要在整个系统范围内保持唯一即可。常见的唯一标识符有如下几种：
- UUID（通用唯一标识符）：它是一个由 32 个十六进制值组成的字符串，可以通过算法生成，具有极高的概率保证唯一性；
- 原子性计数器：是一种在整个系统中维护的计数器，每次请求都会将计数器的值加一，然后将这个值作为唯一标识符传递给后端，后端可以使用这个值来判断请求是否重复；
- 时间戳：使用当前时间戳作为唯一标识符，即可确保这个标识符具有唯一性。但是，在分布式系统中，由于每个服务器的时钟不可能完全同步，因此可能会造成时间戳不唯一的情况。
实际上，使用 UUID 作为标识符是最好的选择，因为它具有极高的概率保证唯一性，并且不需要考虑计数器溢出或时钟漂移等问题。但是，如果你的系统需要处理大量的请求，那么计数器可能会更好一些，因为它比 UUID 更加高效。如果你使用时间戳作为标识符，那么需要确保系统时钟的同步。
无论使用哪种唯一标识符，都需要在 API 接口的响应中返回这个标识符。后续的相同请求就需要在请求头或请求参数中携带这个标识符，以便于后端进行判断。如果标识符相同，那么就可以认为这是一个重复请求，直接返回上一次的结果。
如何防止重复提交？
实现幂等性可以防止请求被多次执行，但是在客户端和服务器之间的网络延迟等原因下，依然有可能导致重复提交。因此，在客户端应当进行防重复提交的控制。
简单来说，防止重复提交的方法是在客户端进行幂等性校验。对于每一个请求，都需要将唯一标识符发往后台，并且在发起请求之前先检查是否已经提交过相同的请求。如果已经提交过，就不发出重复请求。
以下是一段防重复提交的代码示例：
-- -------------------- ---- -------
--- -------- - ---------------------------------
--- -------- - -------------- -- -------
--- ---- - - --- --
-- ---------- -- -------------------- -- --------- - -- --------
--------
---- ------------
----- - --------- --- --
----- -------
-------- -------------- -
-------------------------------- ----------------------
-- ------
--
------ ------------- -
-- ------
-
---
-在这个例子中，客户端在发送请求之前，首先从本地存储中读取上一次请求的数据，判断是否与当前请求相同。如果不同，就发起请求。否则，就认为这是一个重复请求，不需要发出请求。
结论
在 RESTful API 中实现幂等性是非常重要的，它可以确保系统的安全性和可靠性。实现幂等性可以通过唯一标识符来实现。同时，为了防止客户端误操作或者其他原因导致的重复提交，我们可以在客户端进行幂等性校验，防止重复提交。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67025f04d91dce0dc8473d5c