Logo Loona AutomationLoona Narzędzia deweloperskie
Strona główna › Materiały referencyjne

Materiały referencyjne kodów statusu HTTP

W skrócie: wszystkie kody statusu, które mają znaczenie w codziennym programowaniu — co każdy oznacza, kiedy jest używany oraz pułapki (401 kontra 403, 302 kontra 307) — filtrowalne podczas pisania.
🔒 Prywatne z założenia: wszystko działa w przeglądarce na tym urządzeniu. Dane wejściowe nigdy nie są przesyłane na serwer.
KodNazwaZnaczenie
100KontynuujKlient powinien kontynuować z treścią żądania
101Przełączanie protokołówZaakceptowano aktualizację protokołu (np. na WebSocket)
200OKŻądanie się powiodło — domyślna odpowiedź sukcesu
201UtworzonoZasób został utworzony (typowy sukces POST)
202ZaakceptowanoW kolejce do przetwarzania asynchronicznego, jeszcze nieukończone
204Brak treściSukces przy celowo pustej treści
301Przeniesiony na stałeZasób ma nowy stały URL — aktualizuj linki; kapitał SEO się przenosi
302ZnalezionoPrzekierowanie tymczasowe (historycznie nadużywane; zob. 303/307)
303Zobacz inne (See Other)Przekierowanie na GET pod inny URL (post/redirect/get)
304NiezmodyfikowaneKopia z bufora jest nadal ważna — rewaliduj przez ETag/Last-Modified
307Przekierowanie tymczasoweTymczasowe przekierowanie zachowujące metodę i treść
308Przekierowanie stałeStałe przekierowanie zachowujące metodę i treść
400Nieprawidłowe żądanieSerwer nie potrafi sparsować/zrozumieć żądania
401NieautoryzowaneWymagane uwierzytelnienie lub uwierzytelnienie nie powiodło się (mimo nazwy oznacza brak uwierzytelnienia)
403ZabronionyUwierzytelniono lub nie, dostęp jest odmawiany
404Nie znalezionoBrak zasobu pod tym URL
405Metoda niedozwolonaMetoda HTTP nie jest obsługiwana dla tego zasobu
406NieakceptowalneŻadna reprezentacja nie pasuje do nagłówków Accept
408Limit czasu żądaniaKlient zbyt długo wysyłał żądanie
409KonfliktKonflikt stanu, np. kolizja edycji lub zduplikowane utworzenie
410Zniknął (Gone)Trwale usunięty (silniejsze niż 404 — używane celowo)
411Wymagana długośćWymagany jest nagłówek Content-Length
413Treść zbyt dużaTreść żądania przekracza limity serwera
414URI zbyt długiURL przekracza limity serwera
415Nieobsługiwany typ mediówContent-Type żądania nie jest obsługiwany
418Jestem czajnikiem (I'm a Teapot)Żartobliwy kod RFC 2324, czasami używany do odmowy parzenia kawy
422Treść nieprzetwarzalnaSkładnia jest w porządku, ale semantyka nie przechodzi walidacji (API to uwielbiają)
425Za wcześnieSerwer niechętny do przetworzenia możliwie powtórzonego żądania
429Zbyt wiele żądańPrzekroczono limit szybkości — wycofaj się, szanuj Retry-After
500Wewnętrzny błąd serweraOgólna awaria po stronie serwera
501NiezaimplementowaneSerwer nie obsługuje tej funkcjonalności
502Nieprawidłowa bramaProxy/brama otrzymała nieprawidłową odpowiedź od serwera nadrzędnego
503Usługa niedostępnaPrzeciążony lub niedostępny z powodu konserwacji — często tymczasowe, może nieść Retry-After
504Przekroczenie czasu bramyProxy/brama przekroczyła limit czasu oczekiwania na serwer nadrzędny
505Wersja HTTP nieobsługiwanaWersja 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).

Powiązane narzędzia deweloperskie

Osadź to narzędzie na swojej stronie — za darmo

Dodaj to narzędzie do własnej strony internetowej lub bloga — jest całkowicie bezpłatne, nie wymaga rejestracji i zawsze pokazuje najnowszą wersję. Skopiuj poniższy kod i wklej go na swoją stronę tam, gdzie narzędzie ma się pojawić. Zachowanie małej linii kredytowej “Powered by Loona Automation” pod osadzeniem pomaga utrzymać to narzędzie bezpłatnym — ale możesz ją dowolnie stylować lub usunąć; narzędzie działa tak czy inaczej.