冪等性
サーバーを同じ状態にしたまま、同じ効果で同じリクエストを1回または数回連続して行うことができる場合、HTTPメソッドは冪等性です。 言い換えれば、冪等メソッドは、(統計を保持することを除いて)副作用を持つべきではありません。 正しく実装され、GET
HEAD
PUT
DELETE
POST
メソッド。 すべての安全な方法も冪等です。
冪等であるためには、サーバーの実際のバックエンド状態のみが考慮され、各要求によって返されるステータスコードは異なる場合があります。DELETE
200
404
DELETE
DELETE
メソッドを使用して、最後のエントリの削除機能を備えたRESTful Apiを実
メソッドの冪等性はサーバーによって保証されておらず、アプリケーションによっては冪等性制約を誤って破る可能性があることに注意してくださp>
GET /pageX HTTP/1.1
は冪等です。 連続して数回呼び出されると、クライアントは同じ結果を取得します。
GET /pageX HTTP/1.1GET /pageX HTTP/1.1GET /pageX HTTP/1.1GET /pageX HTTP/1.1
POST /add_row HTTP/1.1
冪等ではありません。
POST /add_row HTTP/1.1POST /add_row HTTP/1.1 -> Adds a 2nd rowPOST /add_row HTTP/1.1 -> Adds a 3rd row
DELETE /idX/delete HTTP/1.1
DELETE /idX/delete HTTP/1.1
POST /add_row HTTP/1.1POST /add_row HTTP/1.1 -> Adds a 2nd rowPOST /add_row HTTP/1.1 -> Adds a 3rd row
POST /add_row HTTP/1.1POST /add_row HTTP/1.1 -> Adds a 2nd rowPOST /add_row HTTP/1.1 -> Adds a 3rd row
POST /add_row HTTP/1.1POST /add_row HTTP/1.1 -> Adds a 2nd rowPOST /add_row HTTP/1.1 -> Adds a 3rd row
POST /add_row HTTP/1.1POST /add_row HTTP/1.1 -> Adds a 2nd rowPOST /add_row HTTP/1.1 -> Adds a 3rd row
DELETE /idX/delete HTTP/1.1 -> Returns 200 if idX existsDELETE /idX/delete HTTP/1.1 -> Returns 404 as it just got deletedDELETE /idX/delete HTTP/1.1 -> Returns 404