Наглядный справочник по всем методам запросов HTTP — GET, POST, PUT, PATCH, DELETE и остальным, а также WebDAV — с быстрым обзором того, безопасен ли каждый из них, идемпотентен и кэшируется, передаётся ли тело запроса, и типичным примером. В браузере, бесплатно.

Все стандартные методы запросов HTTP и их семантика бок о бок. Всё работает в вашем браузере из встроенного справочника — ничего не отправляется на сервер.

Метод Назначение Безопасный Идемпотентный Кэшируемый Тело Типичное применение
Ни один метод не соответствует вашему запросу.
Попробуйте другое название или термин — например PATCH, idempotent или cache.
Да Нет Условно Опционально Не рекомендуется

О Методы HTTP

Этот справочник методов HTTP собирает каждый стандартный метод запроса — GET, HEAD, POST, PUT, PATCH, DELETE, CONNECT, OPTIONS и TRACE — плюс распространённые расширения WebDAV в одну удобную для просмотра таблицу. Для каждого метода он отвечает на вопросы, которые реально волнуют разработчиков: безопасен ли он, идемпотентен ли, кэшируется ли, содержит ли тело запроса, и как выглядит типичное использование.

Эти три семантических свойства определяют реальные решения по проектированию. Безопасные методы доступны только для чтения и могут свободно предзагружаться; идемпотентные методы можно повторять после сбоя сети без побочных эффектов, именно это и предполагают прокси и HTTP-клиенты; а кэшируемость определяет, могут ли ответы сохраняться и повторно использоваться.

Поиск сопоставляет имена методов, свойства и варианты использования — PATCH, idempotent и cache одинаково фильтруют таблицу — а переключатель групп отделяет стандартные методы от набора WebDAV. Имя каждого метода копируется в буфер обмена одним щелчком.

Как использовать Методы HTTP

  1. Просмотрите таблицу, чтобы сравнить методы по столбцам Safe, Idempotent, Cacheable и Body.
  2. Выполните поиск по имени, свойству или варианту использования — например, PUT, idempotent или upload.
  3. Переключайтесь между группами Standard и WebDAV, чтобы включать или исключать методы расширения.
  4. Наведите курсор на подсказки заголовков столбцов для простого определения каждого свойства.
  5. Нажмите кнопку копирования, чтобы получить имя метода для спецификации API или теста.

Часто задаваемые вопросы

Безопасный означает, что запрос вообще не изменяет состояние сервера — GET и HEAD доступны только для чтения. Идемпотентный означает, что повторение идентичного запроса имеет тот же эффект, что и его однократная отправка — DELETE идемпотентен, но не безопасен, потому что первый вызов действительно изменяет состояние.

PUT полностью заменяет ресурс телом, которое вы отправляете, и идемпотентен. PATCH применяет частичное изменение — меняются только включённые вами поля — и не гарантированно идемпотентен. Используйте PUT для полной замены и PATCH для точечных обновлений.

Потому что клиенты, прокси и SDK автоматически повторяют идемпотентные запросы после тайм-аутов или обрывов соединения. Неидемпотентный POST, повторённый вслепую, может создать дублирующиеся заказы или записи, поэтому платёжные API сочетают POST с ключами идемпотентности.

Ответы GET и HEAD кэшируются по умолчанию. Ответы POST могут кэшироваться только тогда, когда это разрешают явные заголовки свежести, что на практике редко. Остальные методы не кэшируются — их ответы не должны сохраняться и повторно использоваться.

WebDAV расширяет HTTP для удалённого управления файлами, добавляя такие методы, как PROPFIND, MKCOL, COPY, MOVE, LOCK и UNLOCK. Вы столкнётесь с ними при работе с серверами WebDAV, построенными на них протоколами календаря/контактов или интеграциями сетевых дисков.

Да. Вся таблица бесплатна и работает в вашем браузере на основе встроенного набора данных — поиск и фильтрация ничего не отправляют на сервер.

Поделиться
Нужна помощь?
Возникла проблема с этим инструментом? Сообщите нам.
Сообщить о проблеме

Добавьте этот бесплатный инструмент на свой сайт — скопируйте и вставьте код ниже.