Narzędzia dla programistów
Kody stanu HTTP: przewodnik
Przeszukuj wszystkie kody stanu HTTP od 100 do 511 z jasnymi objaśnieniami, kategoriami i linkami do specyfikacji.
61 kodów stanu
- 100ContinueRFC 9110 · MDN
Serwer odebrał nagłówki; klient powinien wysłać treść.
- 101Switching ProtocolsRFC 9110 · MDN
Serwer zmienia protokół zgodnie z prośbą, np. na WebSocket.
- 102ProcessingRFC 2518 · MDN
Serwer nadal przetwarza długie żądanie WebDAV; brak jeszcze odpowiedzi.
- 103Early HintsRFC 8297 · MDN
Wstępne nagłówki, aby przeglądarka mogła wcześniej zacząć wczytywać zasoby.
Żądanie się powiodło. Treść zawiera zasób lub wynik.
Powodzenie i utworzono nowy zasób, zwykle po POST.
- 202AcceptedRFC 9110 · MDN
Żądanie przyjęto, ale przetwarzanie jeszcze się nie zakończyło.
- 203Non-Authoritative InformationRFC 9110 · MDN
Powodzenie, ale odpowiedź została zmieniona przez serwer pośredniczący.
Powodzenie bez treści odpowiedzi, typowe dla DELETE lub zapisanych formularzy.
- 205Reset ContentRFC 9110 · MDN
Powodzenie; klient powinien zresetować formularz lub widok, który wysłał żądanie.
- 206Partial ContentRFC 9110 · MDN
Zwracana jest tylko część zasobu, zgodnie z nagłówkiem Range.
- 207Multi-StatusRFC 4918 · MDN
Odpowiedź WebDAV z osobnymi stanami dla wielu zasobów.
- 208Already ReportedRFC 5842 · MDN
Elementy WebDAV zostały już wymienione wcześniej w tej odpowiedzi.
- 226IM UsedRFC 3229 · MDN
Serwer zastosował manipulacje instancji (kodowanie delta) do odpowiedzi.
- 300Multiple ChoicesRFC 9110 · MDN
Zasób ma kilka reprezentacji do wyboru.
Zasób przeniesiono na stałe; zaktualizuj linki i zakładki.
Zasób jest tymczasowo pod innym adresem; nadal używaj oryginalnego.
- 303See OtherRFC 9110 · MDN
Pobierz wynik metodą GET z innego adresu, często po wysłaniu formularza.
Kopia w pamięci podręcznej jest nadal ważna, więc treść nie jest wysyłana.
- 307Temporary RedirectRFC 9110 · MDN
Tymczasowe przekierowanie zachowujące metodę i treść.
- 308Permanent RedirectRFC 9110 · MDN
Stałe przekierowanie zachowujące metodę i treść.
Serwer nie może przetworzyć żądania, bo jest źle sformułowane lub nieprawidłowe.
Wymagane jest uwierzytelnienie lub podane dane logowania są nieprawidłowe.
- 402Payment RequiredRFC 9110 · MDN
Zarezerwowany dla płatności; niektóre API używają go, gdy plan lub limit wymaga zapłaty.
Serwer zrozumiał żądanie, ale odmawia jego wykonania.
Serwer nie może znaleźć żądanego zasobu.
Metoda HTTP nie jest obsługiwana dla tego zasobu.
- 406Not AcceptableRFC 9110 · MDN
Żadna reprezentacja nie pasuje do nagłówków Accept klienta.
- 407Proxy Authentication RequiredRFC 9110 · MDN
Klient musi najpierw uwierzytelnić się w serwerze proxy.
- 408Request TimeoutRFC 9110 · MDN
Serwer zbyt długo czekał na dokończenie żądania przez klienta.
Żądanie jest w konflikcie z bieżącym stanem zasobu.
- 410GoneRFC 9110 · MDN
Zasób usunięto na stałe i nie wróci.
- 411Length RequiredRFC 9110 · MDN
Serwer wymaga nagłówka Content-Length.
- 412Precondition FailedRFC 9110 · MDN
Warunek wstępny w nagłówkach, np. If-Match, nie został spełniony.
- 413Content Too LargeRFC 9110 · MDN
Treść żądania jest większa, niż pozwala serwer.
- 414URI Too LongRFC 9110 · MDN
Adres URL jest dłuższy, niż serwer chce obsłużyć.
- 415Unsupported Media TypeRFC 9110 · MDN
Serwer nie obsługuje formatu treści żądania.
- 416Range Not SatisfiableRFC 9110 · MDN
Żądanego zakresu (Range) nie można dostarczyć dla zasobu.
- 417Expectation FailedRFC 9110 · MDN
Serwer nie może spełnić wymagania z nagłówka Expect.
- 418I'm a teapotRFC 2324 · MDN
Żart primaaprilisowy: serwer jest czajnikiem i odmawia parzenia kawy.
- 421Misdirected RequestRFC 9110 · MDN
Żądanie trafiło do serwera, który nie może odpowiadać za ten host.
Żądanie jest poprawnie zbudowane, ale zawiera błędy semantyczne lub walidacji.
- 423LockedRFC 4918 · MDN
Zasób WebDAV jest zablokowany.
- 424Failed DependencyRFC 4918 · MDN
Żądanie nie powiodło się, bo nie powiodło się żądanie, od którego zależało.
- 425Too EarlyRFC 8470 · MDN
Serwer nie przetworzy żądania, które może zostać odtworzone ponownie.
- 426Upgrade RequiredRFC 9110 · MDN
Klient musi przejść na inny protokół, np. TLS lub HTTP/2.
- 428Precondition RequiredRFC 6585 · MDN
Serwer wymaga żądania warunkowego, aby uniknąć utraty zmian.
Klient wysłał zbyt wiele żądań w krótkim czasie (ograniczenie liczby żądań).
- 431Request Header Fields Too LargeRFC 6585 · MDN
Nagłówki żądania albo pojedynczy nagłówek są zbyt duże.
- 451Unavailable For Legal ReasonsRFC 7725 · MDN
Zasób jest niedostępny z przyczyn prawnych, np. z powodu nakazu sądu.
Serwer napotkał nieoczekiwany błąd i nie mógł zakończyć żądania.
- 501Not ImplementedRFC 9110 · MDN
Serwer nie obsługuje funkcji potrzebnej do tego żądania.
Brama lub proxy otrzymały nieprawidłową odpowiedź od serwera nadrzędnego.
Serwer jest chwilowo przeciążony lub w trakcie konserwacji.
Brama lub proxy nie otrzymały na czas odpowiedzi od serwera nadrzędnego.
- 505HTTP Version Not SupportedRFC 9110 · MDN
Serwer nie obsługuje użytej wersji HTTP.
- 506Variant Also NegotiatesRFC 2295 · MDN
Negocjacja treści jest błędnie skonfigurowana na serwerze.
- 507Insufficient StorageRFC 4918 · MDN
Serwer nie może zapisać tego, co potrzebne do zakończenia żądania.
- 508Loop DetectedRFC 5842 · MDN
Serwer wykrył nieskończoną pętlę podczas przetwarzania.
- 510Not ExtendedRFC 2774 · MDN
Serwer wymaga dodatkowych rozszerzeń, aby spełnić żądanie.
- 511Network Authentication RequiredRFC 6585 · MDN
Klient musi się uwierzytelnić, aby uzyskać dostęp do sieci, np. w portalu Wi-Fi.
Czym jest to narzędzie?
Każda odpowiedź HTTP zawiera trzycyfrowy kod, który mówi klientowi, co się stało. Szukaj po numerze lub nazwie, filtruj po klasie i czytaj, co oznacza każdy kod i kiedy go używać — od 200 OK i przekierowań 301 po 404, 429 i 503.
Kody są pogrupowane według pierwszej cyfry: 2xx oznacza powodzenie, 3xx, że klient musi zrobić coś innego (zwykle podążyć za przekierowaniem), 4xx, że żądanie było błędne, a 5xx, że zawiódł serwer.
Lista jest zgodna z RFC 9110 (semantyka HTTP) i innymi RFC, które zarejestrowały dodatkowe kody, np. 429 Too Many Requests (RFC 6585) i 451 Unavailable For Legal Reasons (RFC 7725).
Jak używać: Kody stanu HTTP
- Wpisz kod (np. 404) lub słowo (np. przekierowanie) w polu wyszukiwania.
- Filtruj po klasie: 1xx informacyjne, 2xx powodzenie, 3xx przekierowanie, 4xx błędy klienta lub 5xx błędy serwera.
- Zaznacz „Tylko najczęstsze”, aby zobaczyć kody spotykane najczęściej.
- Skopiuj kod z nazwą lub otwórz stronę MDN ze wszystkimi szczegółami.
Przykłady
Przekierowania
301 i 308 są stałe; 302, 303 i 307 tymczasowe. 307 i 308 zachowują oryginalną metodę i treść.
Najczęstsze pytania
Czym różni się 401 od 403?
401 Unauthorized oznacza brak uwierzytelnienia (zaloguj się lub wyślij poprawny token). 403 Forbidden oznacza, że serwer wie, kim jesteś, ale nie masz uprawnień.
Użyć 301 czy 302 przy przekierowaniu?
Użyj 301 (lub 308), gdy przeniesienie jest stałe, aby wyszukiwarki przeniosły pozycję na nowy adres. Użyj 302 (lub 307) dla przekierowań tymczasowych.
Kiedy API powinno zwrócić 422?
Gdy żądanie jest poprawnym JSON (lub formularzem), ale nie przechodzi walidacji — np. brakuje wymaganego pola albo adres e-mail jest błędny. Dla źle zbudowanych żądań użyj 400.
Co oznacza 503 Service Unavailable?
Serwer chwilowo nie może obsługiwać żądań, często z powodu konserwacji lub przeciążenia. Nagłówek Retry-After może podpowiedzieć klientom, kiedy spróbować ponownie.
Potrzebujesz w przyszłości więcej możliwości?
Narzędzia premium, wyższe limity i dostęp przez API są w planach. Wersja 1 pozostaje darmowa i prywatna w Twojej przeglądarce.