Какие HTTP-методы идемпотентны?

Идемпотентность — свойство, при котором многократное выполнение запроса даёт тот же эффект на сервере, что и однократное. Ответы при этом могут различаться: первый DELETE /orders/5 вернёт 204, второй — 404, но заказ удалён и после одного, и после двух вызовов.

По спецификации HTTP:

• безопасные методы — GET, HEAD, OPTIONS — не должны менять состояние вообще; они автоматически идемпотентны;
• PUT — «положить ресурс целиком в это состояние» — идемпотентен;
• DELETE — идемпотентен;
• POST — «обработать» или «создать» — не идемпотентен: два запроса создают два ресурса;
• PATCH — не гарантирует: «установить поле» идемпотентно, «прибавить к счётчику» — нет.

Почему это важно: сеть ненадёжна, и клиент, не получив ответа, не знает, выполнился ли запрос. Идемпотентные запросы можно безопасно повторить — так делают HTTP-клиенты с повторами, балансировщики и прокси. Браузер предупреждает о повторной отправке формы именно потому, что POST — не идемпотентен.

Проектирование API: не менять состояние в GET (иначе краулер или предзагрузка удалят данные); для создания — POST с ключом идемпотентности или PUT с идентификатором от клиента.