Idempotency in RESTful API

同じリクエストを何度繰り返しても、同じリソース状態になること

得られる結果というのはリソース状態であって、レスポンスではない

利用者側が気にすべき前提・事前条件が減る、つまり使いやすいエンドポイントになる

POST, PATCHは冪等ではないとRFC7231で定められている

下の表は、一般的に使用される HTTP メソッドとその安全性、および idempotency を示す

code:table

Idempotence in HTTP

+-------------------+--------------+-------------------+

| Http Method | Safety | Idempotency |

+-------------------+--------------+-------------------+

| GET | Yes | Yes |

| PUT | No | Yes |

| POST | No | No |

| DELETE | No | Yes |

| PATCH | No | No |

+-------------------+--------------+-------------------+

参考