Przejrzysty wykaz każdej metody żądania HTTP — GET, POST, PUT, PATCH, DELETE i pozostałych, plus WebDAV — pokazujący na pierwszy rzut oka, czy każda jest bezpieczna, idempotentna i buforowalna, czy przyjmuje treść oraz typowy przykład. W przeglądarce, bezpłatnie.

Każda standardowa metoda żądania HTTP i jej semantyka, obok siebie. Wszystko działa w Twojej przeglądarce na podstawie wbudowanego wykazu — nic nie jest wysyłane na serwer.

Metoda Przeznaczenie Bezpieczna Idempotentna Buforowalna Treść Typowe użycie
Żadna metoda nie pasuje do wyszukiwania.
Spróbuj innej nazwy lub terminu — na przykład PATCH, idempotentna lub cache.
Tak Nie Warunkowo Opcjonalnie Odradzane

O Metody HTTP

Ten odnośnik metod HTTP zbiera każdą standardową metodę żądania — GET, HEAD, POST, PUT, PATCH, DELETE, CONNECT, OPTIONS i TRACE — plus popularne rozszerzenia WebDAV w jednej przejrzystej tabeli. Dla każdej metody odpowiada na pytania, nad którymi programiści faktycznie się zastanawiają: czy jest bezpieczna, czy jest idempotentna, czy jest cache’owalna, czy niesie treść żądania i jak wygląda typowe zastosowanie.

Te trzy właściwości semantyczne napędzają realne decyzje projektowe. Bezpieczne metody są tylko do odczytu i mogą być swobodnie pobierane z wyprzedzeniem; idempotentne metody mogą być powtarzane po awarii sieci bez efektów ubocznych, co dokładnie zakładają proxy i klienci HTTP; a cache’owalność decyduje o tym, czy odpowiedzi mogą być przechowywane i ponownie wykorzystywane.

Wyszukiwanie dopasowuje nazwy metod, właściwości i przypadki użycia — PATCH, idempotent i cache wszystkie filtrują tabelę — a przełącznik grupy oddziela metody standardowe od zestawu WebDAV. Każda nazwa metody kopiuje się do schowka jednym kliknięciem.

Jak korzystać z Metody HTTP

  1. Przejrzyj tabelę, aby porównać metody w kolumnach Bezpieczna, Idempotentna, Cache’owalna i Treść.
  2. Wyszukaj po nazwie, właściwości lub przypadku użycia — na przykład PUT, idempotent lub upload.
  3. Przełączaj się między grupami Standardowe i WebDAV, aby uwzględnić lub wykluczyć metody rozszerzenia.
  4. Najedź na podpowiedzi kolumn, aby uzyskać zwykłe wyjaśnienie każdej właściwości.
  5. Kliknij przycisk kopiowania, aby pobrać nazwę metody do specyfikacji API lub testu.

Najczęściej zadawane pytania

Bezpieczna oznacza, że żądanie w ogóle nie zmienia stanu serwera — GET i HEAD są tylko do odczytu. Idempotentna oznacza, że powtórzenie identycznego żądania ma taki sam efekt jak wysłanie go raz — DELETE jest idempotentna, ale nie bezpieczna, ponieważ pierwsze wywołanie faktycznie zmienia stan.

PUT zastępuje cały zasób treścią, którą wysyłasz, i jest idempotentna. PATCH stosuje częściową modyfikację — zmieniają się tylko pola, które uwzględnisz — i nie ma gwarancji idempotentności. Użyj PUT dla pełnych zastąpień i PATCH dla ukierunkowanych aktualizacji.

Ponieważ klienci, proxy i SDK automatycznie ponawiają idempotentne żądania po przekroczeniu limitu czasu lub zerwaniu połączenia. Nieidempotentny POST ponowiony na ślepo może utworzyć duplikaty zamówień lub rekordów, dlatego API płatnicze łączą POST z kluczami idempotencji.

Odpowiedzi GET i HEAD są domyślnie cache’owalne. Odpowiedzi POST mogą być cache’owane tylko wtedy, gdy zezwalają na to jawne nagłówki świeżości, co w praktyce jest rzadkie. Pozostałe metody nie są cache’owalne — ich odpowiedzi nie mogą być przechowywane i ponownie wykorzystywane.

WebDAV rozszerza HTTP o zarządzanie plikami zdalnymi, dodając metody takie jak PROPFIND, MKCOL, COPY, MOVE, LOCK i UNLOCK. Spotkasz je pracując z serwerami WebDAV, protokołami kalendarza/kontaktów zbudowanymi na ich bazie lub integracjami dysków sieciowych.

Tak. Cała tabela jest darmowa i działa w Twojej przeglądarce na wbudowanym zestawie danych — wyszukiwanie i filtrowanie nie wysyłają niczego do serwera.

Potrzebujesz pomocy?
Masz problem z tym narzędziem? Daj nam znać.
Zgłoś problem

Dodaj to darmowe narzędzie do swojej witryny — skopiuj i wklej poniższy kod.