Metody HTTP

Czym są metody HTTP? Operacje na zasobach

Protokół Transferu Hipertekstu (HTTP) to protokół warstwy aplikacji używany przez przeglądarki internetowe (klientów) i serwery WWW do wymiany komunikatów. W jego skład wchodzą między innymi metody HTTP. Nazwy metod są tokenami rozróżnianymi wielkością liter i są rejestrowane przez IANA. Wskazują one serwerowi, co klient chce zrobić z określonym zasobem, takim jak strona internetowa, obraz, wideo lub dane z bazy danych.

Kiedy przeglądarka wysyła żądanie do serwera, metoda jest jednym z jego pierwszych elementów i określa semantykę operacji. Prośba o dostarczenie strony internetowej ma inny cel niż zapisanie nowego zdjęcia profilowego użytkownika. Rozdzielenie operacji na metody ułatwia serwerom i interfejsom API spójne stosowanie semantyki HTTP. Popularne metody poniżej porównano według celu i właściwości.

Podstawowe metody HTTP

Istnieje wiele metod HTTP, lecz kilka z nich obsługuje większość typowych interakcji w internecie. Ich właściwości pomagają zrozumieć działanie usług webowych.

Metodę interpretuje się razem z docelowym URI, polami żądania, treścią i semantyką zasobu, które wpływają na odpowiedź oraz kod statusu.

Żądanie
GET /uzytkownicy/profil/123 HTTP/1.1
Host: api.example.com
Accept: application/json

Odpowiedź
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 104

{
  "userId": 123,
  "username": "JanKowalski",
  "email": "jan.kowalski@example.com"
}

Żądanie
POST /uzytkownicy HTTP/1.1
Host: api.example.com
Content-Type: application/json
Content-Length: 56

{
  "username": "AnnaNowak",
  "password": "supersecret"
}

Odpowiedź
HTTP/1.1 201 Created
Location: /uzytkownicy/456

{
  "userId": 456,
  "message": "Użytkownik utworzony pomyślnie"
}

Żądanie
PUT /uzytkownicy/123 HTTP/1.1
Host: api.example.com
Content-Type: application/json

{
  "username": "JanKowalski",
  "email": "jan.nowy.email@example.com"
}

Odpowiedź
HTTP/1.1 200 OK

{
  "userId": 123,
  "username": "JanKowalski",
  "email": "jan.nowy.email@example.com"
}

Żądanie
DELETE /uzytkownicy/123 HTTP/1.1
Host: api.example.com

Odpowiedź
HTTP/1.1 204 No Content

Żądanie
HEAD /pobieranie/duzy-plik.zip HTTP/1.1
Host: storage.example.com

Odpowiedź
HTTP/1.1 200 OK
Content-Type: application/zip
Content-Length: 104857600
Last-Modified: Fri, 15 Jun 2025 10:00:00 GMT

Metody dodatkowe: narzędzia specjalistyczne

Poza metodami podstawowymi, HTTP definiuje kilka innych o bardziej wyspecjalizowanych celach, często używanych w tworzeniu API lub do diagnostyki sieci.

OPTIONS

Metoda $OPTIONS$ służy do opisywania opcji komunikacji dla zasobu docelowego. Klient może użyć $OPTIONS$, aby dowiedzieć się, które metody HTTP serwer obsługuje dla określonego adresu URL. Mechanizm CORS (Cross-Origin Resource Sharing) wykorzystuje takie żądanie do sprawdzenia uprawnień. Zanim przeglądarka wyśle złożone żądanie do innej domeny (np. $PUT$ lub $DELETE$), najpierw wysyła żądanie $OPTIONS$ (tzw. żądanie pre-flight), aby zapytać serwer o pozwolenie.

PATCH

Metoda $PATCH$ służy do stosowania częściowych modyfikacji zasobu. Podczas gdy $PUT$ zastępuje cały zasób, $PATCH$ dostarcza zestaw instrukcji, jak go zmienić. Na przykład, żądanie $PATCH$ może zawierać tylko instrukcję zmiany adresu e-mail użytkownika, pozostawiając nazwę użytkownika i inne pola nietknięte. Może to być bardziej wydajne niż przesyłanie całej reprezentacji zasobu. $PATCH$nie jest bezpieczne i, co ważne, niekoniecznie jest idempotentne. Na przykład, instrukcja patch "dodaj 10 do wyniku użytkownika" dałaby inny wynik, gdyby została wysłana dwukrotnie.

CONNECT

Metoda $CONNECT$ ustanawia tunel do serwera zidentyfikowanego przez zasób docelowy. W typowym użyciu służy do zestawienia połączenia $HTTPS$ przez proxy $HTTP$. Proxy może wtedy zestawić połączenie z hostem docelowym i przekazywać bajty w obu kierunkach. Treść HTTPS pozostaje dla niego nieczytelna bez terminacji TLS.

TRACE

Metoda $TRACE$ wykonuje test pętli zwrotnej wiadomości wzdłuż ścieżki do zasobu docelowego. Pozwala klientowi zobaczyć, jakie (jeśli w ogóle) zmiany lub dodatki zostały wprowadzone przez serwery pośredniczące (np. proxy) do komunikatu żądania. Jest to narzędzie do debugowania i diagnostyki. Ze względu na potencjalne ryzyka bezpieczeństwa (Cross-Site Tracing), jest często wyłączana na produkcyjnych serwerach internetowych.

Bezpieczeństwo a idempotencja metod HTTP

Bezpieczeństwo i idempotencja opisują różne cechy. Bezpieczeństwo dotyczy żądanej operacji, a idempotencja jej zamierzonego skutku przy powtórzeniu żądania.