Справочник методов HTTP

• Мгновенный поиск по всем методам HTTP: наш справочник позволяет искать по названию метода, описанию или сценарию использования в реальном времени. Найдите именно то, что нужно: правила идемпотентности, коды состояния или требования к телу запроса.
• Раскрывающиеся карточки с полной семантикой: каждая карточка метода HTTP раскрывается и показывает полную семантику: свойства безопасный/идемпотентный/кэшируемый, типичные сценарии, требования к телу запроса, коды состояния успеха и ошибок и готовые примеры запросов.
• Безопасный онлайн-справочник методов HTTP: он работает полностью в браузере - данные не отправляются на сервер. Все справочные данные загружаются локально, поэтому после загрузки страницы инструмент работает полностью офлайн.
• Справочник методов HTTP без установки, 100 % бесплатно: пользуйтесь им прямо в любом браузере, без загрузок, аккаунта и рекламы. Фильтруйте по методу, раскрывайте все карточки сразу и копируйте примеры запросов - совершенно бесплатно навсегда.

• Проектирование REST API: используйте наш справочник, чтобы выбрать правильный метод при проектировании REST API. Понимайте, когда применять PUT вместо PATCH или POST вместо PUT, чтобы создавать семантически корректные и предсказуемые эндпоинты.
• Интеграция и отладка API: разработчики, интегрирующие сторонние API, используют наш справочник, чтобы понять, что делает каждый метод и каких кодов состояния ожидать. Быстро проверяйте, идемпотентен ли метод, прежде чем повторять неудачные запросы.
• Разработка бэкенда: бэкенд-инженеры используют наш справочник, чтобы реализовать корректные обработчики маршрутов. Понимайте, какие методы требуют тело запроса, какие должны возвращать 201 вместо 200 и какие можно кэшировать.
• Разработка фронтенда и клиентов: фронтенд-разработчики используют наш справочник, чтобы писать корректные вызовы fetch и Axios. Знайте, когда использовать POST для форм, GET для получения данных и DELETE для удаления ресурсов.
• Написание документации API: технические писатели используют наш справочник, чтобы точно документировать API. Ссылайтесь на корректную семантику, правила идемпотентности и коды состояния каждого метода в документации OpenAPI или Swagger.
• Обучение и подготовка к собеседованиям: разработчики, изучающие REST или готовящиеся к техническим собеседованиям, используют наш справочник, чтобы освоить семантику HTTP. Разберитесь в безопасных и идемпотентных методах, preflight CORS и разнице между PUT и PATCH.

Методы HTTP (также называемые HTTP-глаголами) определяют действие, выполняемое над ресурсом, идентифицируемым URL. Они являются основной частью протокола HTTP и фундаментом проектирования RESTful API. Самые используемые методы: GET (получить), POST (создать), PUT (заменить), PATCH (частично обновить) и DELETE (удалить). Другие методы вроде HEAD , OPTIONS , CONNECT и TRACE служат специальным целям. Наш справочник методов HTTP охватывает все стандартные методы с их семантикой, сценариями использования и деталями запросов и ответов.

1. Просматривайте или ищите: используйте строку поиска, чтобы найти любой метод HTTP по названию, описанию или сценарию. Или нажмите на фильтр-пилюлю (GET, POST, PUT и т. д.), чтобы сразу перейти к методу. Вся фильтрация выполняется мгновенно в браузере.
2. Раскройте для полной информации: нажмите на любую карточку метода, чтобы раскрыть её и увидеть полный справочник: свойства безопасный/идемпотентный/кэшируемый, сценарии использования, требования к телу запроса, коды состояния успеха и ошибок и примеры HTTP-запросов. Используйте «Раскрыть всё», чтобы открыть все методы сразу.
3. Копируйте примеры запросов: каждый метод включает готовые к копированию примеры HTTP-запросов. Нажмите кнопку «Копировать» у любого примера, чтобы скопировать его в буфер обмена и использовать в API-клиенте, документации или коде.

• Безопасный: метод безопасен, если он не изменяет состояние сервера. GET, HEAD и OPTIONS безопасны - они только получают информацию. POST, PUT, PATCH и DELETE не безопасны, потому что изменяют данные на сервере.
• Идемпотентный: метод идемпотентен, если повторение одного и того же запроса несколько раз даёт тот же результат, что и один раз. GET, HEAD, OPTIONS, PUT и DELETE идемпотентны. POST - нет: отправка одного и того же POST дважды обычно создаёт два ресурса.
• Кэшируемый: метод кэшируем, если его ответы можно сохранять и переиспользовать. Ответы GET и HEAD кэшируются по умолчанию. Ответы POST кэшируются только с явными заголовками Cache-Control. Ответы PUT, PATCH и DELETE не кэшируются.
• Тело запроса: некоторые методы несут тело запроса (POST, PUT, PATCH), другие - нет (GET, HEAD, DELETE, OPTIONS). Отправка тела с GET технически разрешена, но настоятельно не рекомендуется и часто игнорируется серверами.

PUT заменяет ресурс целиком: нужно отправить все поля, а любое не включённое поле будет установлено в null или значение по умолчанию. Используйте PUT, когда нужно полностью заменить ресурс. PATCH применяет частичное обновление: меняются только отправленные поля, а все остальные остаются без изменений. Используйте PATCH, когда нужно обновить одно или несколько полей. На практике большинство современных REST API предпочитают PATCH для обновлений, потому что это эффективнее и меньше подвержено ошибкам, чем отправка всего ресурса при каждом обновлении.