幂等API？

Question

我正在创建一个新的基于REST的API，它允许客户端查询和检索事务的状态(他们之前发送或创建的事务)。这是客户端查询和获取事务状态的能力。事务本身可以在其生命周期中改变其状态，即最初批准，稍后可能由于后台或其他操作而被撤销等。

当客户端调用此查询API时，根据它们在事务生命周期中进行调用的时间，它们将获得事务的详细信息和状态的历史记录(已批准、已撤消等)。API响应可能因调用时间的不同而有所不同。此API是否符合“幂等”API的要求？

提前感谢！！

Answer 1

确实如此。根据RFC 2616: 9.1.2 Idempotent Methods的说法

方法还可以具有“幂等性”属性，因为(除了错误或过期问题之外)N>0个相同请求的副作用与单个请求__相同。GET、HEAD、PUT和DELETE方法共享此属性。此外，方法选项和跟踪不应该有副作用，因此本质上是幂等的。

这里的关键是“副作用”。由于您的请求不会更改API的状态作为副作用，因此任何数量的请求都应该与单个请求具有相同的效果。