Materiały referencyjne kodów statusu HTTP
| Kod | Nazwa | Znaczenie |
|---|---|---|
| 100 | Kontynuuj | Klient powinien kontynuować z treścią żądania |
| 101 | Przełączanie protokołów | Zaakceptowano aktualizację protokołu (np. na WebSocket) |
| 200 | OK | Żądanie się powiodło — domyślna odpowiedź sukcesu |
| 201 | Utworzono | Zasób został utworzony (typowy sukces POST) |
| 202 | Zaakceptowano | W kolejce do przetwarzania asynchronicznego, jeszcze nieukończone |
| 204 | Brak treści | Sukces przy celowo pustej treści |
| 301 | Przeniesiony na stałe | Zasób ma nowy stały URL — aktualizuj linki; kapitał SEO się przenosi |
| 302 | Znaleziono | Przekierowanie tymczasowe (historycznie nadużywane; zob. 303/307) |
| 303 | Zobacz inne (See Other) | Przekierowanie na GET pod inny URL (post/redirect/get) |
| 304 | Niezmodyfikowane | Kopia z bufora jest nadal ważna — rewaliduj przez ETag/Last-Modified |
| 307 | Przekierowanie tymczasowe | Tymczasowe przekierowanie zachowujące metodę i treść |
| 308 | Przekierowanie stałe | Stałe przekierowanie zachowujące metodę i treść |
| 400 | Nieprawidłowe żądanie | Serwer nie potrafi sparsować/zrozumieć żądania |
| 401 | Nieautoryzowane | Wymagane uwierzytelnienie lub uwierzytelnienie nie powiodło się (mimo nazwy oznacza brak uwierzytelnienia) |
| 403 | Zabroniony | Uwierzytelniono lub nie, dostęp jest odmawiany |
| 404 | Nie znaleziono | Brak zasobu pod tym URL |
| 405 | Metoda niedozwolona | Metoda HTTP nie jest obsługiwana dla tego zasobu |
| 406 | Nieakceptowalne | Żadna reprezentacja nie pasuje do nagłówków Accept |
| 408 | Limit czasu żądania | Klient zbyt długo wysyłał żądanie |
| 409 | Konflikt | Konflikt stanu, np. kolizja edycji lub zduplikowane utworzenie |
| 410 | Zniknął (Gone) | Trwale usunięty (silniejsze niż 404 — używane celowo) |
| 411 | Wymagana długość | Wymagany jest nagłówek Content-Length |
| 413 | Treść zbyt duża | Treść żądania przekracza limity serwera |
| 414 | URI zbyt długi | URL przekracza limity serwera |
| 415 | Nieobsługiwany typ mediów | Content-Type żądania nie jest obsługiwany |
| 418 | Jestem czajnikiem (I'm a Teapot) | Żartobliwy kod RFC 2324, czasami używany do odmowy parzenia kawy |
| 422 | Treść nieprzetwarzalna | Składnia jest w porządku, ale semantyka nie przechodzi walidacji (API to uwielbiają) |
| 425 | Za wcześnie | Serwer niechętny do przetworzenia możliwie powtórzonego żądania |
| 429 | Zbyt wiele żądań | Przekroczono limit szybkości — wycofaj się, szanuj Retry-After |
| 500 | Wewnętrzny błąd serwera | Ogólna awaria po stronie serwera |
| 501 | Niezaimplementowane | Serwer nie obsługuje tej funkcjonalności |
| 502 | Nieprawidłowa brama | Proxy/brama otrzymała nieprawidłową odpowiedź od serwera nadrzędnego |
| 503 | Usługa niedostępna | Przeciążony lub niedostępny z powodu konserwacji — często tymczasowe, może nieść Retry-After |
| 504 | Przekroczenie czasu bramy | Proxy/brama przekroczyła limit czasu oczekiwania na serwer nadrzędny |
| 505 | Wersja HTTP nieobsługiwana | Wersja HTTP w żądaniu nie jest obsługiwana |
O nas
Kody statusu to jedno-liczbowe podsumowanie każdej odpowiedzi przez serwer, grupowane według klasy: 1xx informacyjne, 2xx sukces, 3xx przekierowanie, 4xx błąd klienta, 5xx błąd serwera. Tabela podaje kody, które pracujący programiści faktycznie spotykają, wraz z niuansami, które mają znaczenie w praktyce — 401 oznacza nieuwierzytelniony pomimo swojej nazwy, 403 to odmowa niezależnie od logowania, 422 to niepowodzenie walidacji API, 429 wymaga wycofania się. Kody niewymienione (długi ogon 1xx i kody eksperymentalne) są na tyle rzadkie, że sama klasa mówi, jak sobie z nimi radzić.
Często zadawane pytania
Jaka jest różnica między 401 a 403?
401: nie wiemy, kim jesteś (uwierzytelnij się). 403: wiemy, kim jesteś, a mimo to nie wolno.
302 czy 307 dla tymczasowego przekierowania?
307 zachowuje metodę i treść żądania; 302 historycznie pozwalał klientom zmienić POST na GET. W nowych projektach należy używać 307 (lub 308 dla stałego przekierowania).