Прегледен справочник за всеки HTTP метод на заявка — GET, POST, PUT, PATCH, DELETE и останалите, плюс WebDAV — показващ с един поглед дали всеки е безопасен, идемпотентен и кешируем, дали приема тяло, и типичен пример. В браузъра, безплатно.

Всеки стандартен HTTP метод на заявка и неговата семантика, един до друг. Всичко работи в браузъра ви от вграден справочник — нищо не се изпраща към сървъра.

Метод Предназначение Безопасен Идемпотентен Кешируем Тяло Типична употреба
Няма метод, който да отговаря на търсенето ви.
Опитайте друго име или термин — например PATCH, идемпотентен или 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 сървъри, протоколи за календар/контакти, изградени върху тях, или интеграции с мрежови дискове.

Да. Цялата таблица е безплатна и работи в браузъра ви от вграден набор от данни — търсенето и филтрирането не изпращат нищо към сървъра.

Сподели
Нуждаете се от помощ?
Открихте проблем с този инструмент? Кажете ни.
Докладване на проблем

Добавете този безплатен инструмент към собствения си уебсайт — копирайте и поставете кода по-долу.