Metody HTTP wyrażają twój zamiar wobec zasobu; kody statusu to zakodowana odpowiedź serwera. Dla metod liczą się dwie właściwości: safe (tylko do odczytu, bez efektów ubocznych) i idempotent (powtórzenie daje ten sam wynik — ważne dla bezpiecznych ponowień).
| Metoda | Cel | Safe | Idempotent |
|---|
| GET | Odczyt zasobu | Yes | Yes |
| POST | Utworzenie / wyzwolenie akcji | No | No |
| PUT | Zastąpienie zasobu | No | Yes |
| PATCH | Częściowa aktualizacja | No | No* |
| DELETE | Usunięcie zasobu | No | Yes |
| HEAD | Jak GET, tylko nagłówki | Yes | Yes |
Rozróżnienie idempotencji jest praktyczne: ponieważ PUT i DELETE są idempotentne, klient może bezpiecznie je ponowić po timeout; ponowienie nieidempotentnego POST grozi utworzeniem duplikatu (klasyczny błąd podwójnego obciążenia).
Kody statusu są pogrupowane według pierwszej cyfry:
1xx Informational request received, continuing (100 Continue, 101 Switching)
2xx Success it worked (200 OK, 201 Created, 204 No Content)
3xx Redirection go elsewhere (301 Moved, 304 Not Modified)
4xx Client error YOUR request is wrong (400, 401, 403, 404, 429)
5xx Server error the SERVER failed (500, 502, 503, 504)
Najważniejszą linią jest podział 4xx vs 5xx: 4xx oznacza, że klient wysłał coś złego (błędne dane, brak uwierzytelnienia, nie znaleziono) — ponowienie bez zmian nie pomoże; 5xx oznacza, że serwer zawiódł — ponowienie (z backoffem) może się udać. Znaj codzienne na wyrywki: 401 (nieuwierzytelniony) vs 403 (uwierzytelniony, ale niedozwolony), 404 (nie znaleziono), 429 (ograniczenie tempa), 500 (ogólny crash serwera), 502/503/504 (bad gateway / niedostępny / gateway timeout — zwykle problem upstream lub przeciążenia).
Te kody to wspólny kontrakt między każdym klientem a serwerem, więc biegłość tutaj jest oczekiwana od każdego, kto buduje lub konsumuje API. Rekruterzy badają rozróżnienia, które ujawniają prawdziwe zrozumienie: 401 vs 403, PUT vs PATCH, a zwłaszcza idempotencję, która wprost rządzi tym, czy ponowienia są bezpieczne — kluczowa kwestia w systemach rozproszonych i przepływach płatności. Zwracanie właściwego kodu statusu sprawia też, że twoje API jest przewidywalne i poprawnie obsługiwane przez cache, proxy i biblioteki klienckie, więc ta wiedza kształtuje dobry projekt API, a nie tylko ciekawostkę.
Biblioteka pytań rekrutacyjnych IT ze szczegółowymi odpowiedziami — od Juniora do Seniora.
Wesprzyj