Zawartość

    Lista kodów statusu HTTP: Kompletny przewodnik i przykłady

    Pełna lista kodów statusu HTTP z szczegółowymi wyjaśnieniami. Zebraliśmy wszystkie 96 kodów odpowiedzi HTTP (63 powszechne i 33 niestandardowe), aby pomóc Ci lepiej zrozumieć ich cel i właściwe użycie w tworzeniu stron internetowych.
    Kody 1xx
    100 ContinueSerwer otrzymał początkową część żądania i czeka na resztę.
    101 Switching ProtocolsKlient zażądał zmiany protokołu, a serwer wykonuje tę zmianę.
    102 ProcessingSerwer zaakceptował żądanie, ale przetwarzanie trwa dłużej.
    103 Early HintsSerwer wysyła nagłówki z wyprzedzeniem, zanim pełna odpowiedź będzie gotowa.
    Kody 2xx
    200 OKŻądanie zostało pomyślnie przetworzone, a serwer dostarczył żądane dane.
    201 CreatedZasób został pomyślnie utworzony. Serwer zawiera nagłówek Location z adresem utworzonego zasobu.
    202 AcceptedŻądanie zostało przyjęte, ale przetwarzanie zostanie zakończone później. Odpowiedź może zawierać dodatkowe informacje o statusie.
    203 Non-Authoritative InformationOdpowiedź zawiera informacje uzyskane z zewnętrznego źródła, a nie z głównego serwera.
    204 No ContentSerwer pomyślnie przetworzył żądanie, ale nie zwraca żadnej treści. Przeglądarka nie powinna aktualizować bieżącego dokumentu.
    205 Reset ContentKlient powinien zresetować formularz wprowadzania użyty w bieżącej interakcji.
    206 Partial ContentSerwer wysyła tylko część żądanego zasobu, zgodnie z nagłówkiem Content-Range.
    207 Multi-StatusOdpowiedź zawiera wiele niezależnych kodów statusu dla różnych części żądania.
    208 Already ReportedElement został już wcześniej wymieniony w tej samej odpowiedzi.
    218 This is fineNieoficjalny kod wskazujący, że serwer pomyślnie przetworzył żądanie, ale z drobnymi problemami.
    226 IM UsedSerwer zakończył żądanie GET i zastosował jeden lub więcej algorytmów transformacji zasobów.
    Kody 3xx
    300 Multiple ChoicesŻądany zasób jest dostępny w wielu wariantach. Serwer może dostarczyć listę możliwych opcji.
    301 Moved PermanentlyZasób został trwale przeniesiony na nowy adres określony w nagłówku Location.
    302 FoundZasób jest tymczasowo dostępny pod innym adresem, ale stary URL może być użyty ponownie w przyszłości.
    303 See OtherZasób jest dostępny pod innym adresem określonym w nagłówku Location.
    304 Not ModifiedZasób nie został zmodyfikowany od ostatniego żądania, a używana jest wersja z pamięci podręcznej.
    305 Use ProxyDostęp do zasobu jest możliwy tylko przez określony serwer proxy.
    306 Switch ProxyTen kod jest zarezerwowany, ale nie jest używany w nowoczesnych implementacjach HTTP.
    307 Temporary RedirectZasób został tymczasowo przeniesiony, ale metoda żądania musi pozostać niezmieniona.
    308 Permanent RedirectZasób został trwale przeniesiony na nowy URL, a metoda żądania musi być zachowana.
    Kody 4xx
    400 Bad RequestŻądanie jest nieprawidłowe z powodu błędu składni.
    401 UnauthorizedWymagana jest autoryzacja użytkownika, aby uzyskać dostęp do zasobu.
    402 Payment RequiredDostęp do zasobu wymaga płatności.
    403 ForbiddenDostęp do zasobu jest zabroniony przez serwer.
    404 Not FoundŻądany zasób nie został znaleziony.
    405 Method Not AllowedMetoda żądania nie jest obsługiwana przez serwer dla tego zasobu.
    406 Not AcceptableFormat odpowiedzi serwera nie odpowiada żądaniu klienta.
    407 Proxy Authentication RequiredWymagana jest autoryzacja przez serwer proxy.
    408 Request TimeoutŻądanie przekroczyło limit czasu; połączenie zostało zamknięte.
    409 ConflictŻądanie nie może zostać zrealizowane z powodu konfliktu z aktualnym stanem zasobu.
    410 GoneŻądany zasób nie jest już dostępny i nie będzie przywrócony.
    411 Length RequiredSerwer wymaga nagłówka Content-Length.
    412 Precondition FailedJedna z prekonieczności w żądaniu nie została spełniona.
    413 Payload Too LargeRozmiar żądania przekracza dozwolony limit serwera.
    414 URI Too LongŻądany URI jest zbyt długi, aby serwer mógł go przetworzyć.
    415 Unsupported Media TypeFormat danych żądania nie jest obsługiwany przez serwer.
    416 Range Not SatisfiableŻądany zakres nie może być przetworzony przez serwer.
    417 Expectation FailedSerwer nie może zrealizować wartości nagłówka Expect.
    418 I’m a TeapotSerwer odmawia parzenia kawy, ponieważ jest czajnikiem.
    419 Page ExpiredSesja użytkownika wygasła.
    420 Method FailureNiepowodzenie metody.
    420 Enhance Your CalmZbyt wiele żądań, proszę zmniejszyć obciążenie.
    421 Misdirected RequestŻądanie zostało skierowane do serwera, który nie może go przetworzyć.
    422 Unprocessable EntitySerwer nie może przetworzyć żądania z powodu błędu w treści.
    423 LockedDostęp do zasobu jest zablokowany.
    424 Failed DependencyŻądanie nie powiodło się z powodu błędu w żądaniu zależnym.
    425 Too EarlySerwer odmawia przetworzenia żądania, ponieważ zostało ono wysłane zbyt wcześnie.
    426 Upgrade RequiredKlient musi zaktualizować do innego protokołu, aby zakończyć żądanie.
    428 Precondition RequiredSerwer wymaga, aby żądanie spełniało określone prekonieczności.
    429 Too Many RequestsKlient wysłał zbyt wiele żądań w krótkim czasie.
    430 Shopify Security RejectionŻądanie zostało odrzucone przez system zabezpieczeń Shopify.
    430 Shopify Security RejectionŻądanie zostało odrzucone przez system zabezpieczeń Shopify.
    431 Request Header Fields Too LargeNagłówki żądania są zbyt duże, aby serwer mógł je przetworzyć.
    440 Login Time-outSesja użytkownika wygasła.
    444 No ResponseSerwer zamknął połączenie bez wysyłania odpowiedzi.
    449 Retry WithWymagane są dodatkowe informacje, aby przetworzyć żądanie.
    450 Blocked by Windows Parental ControlsDostęp do zasobu jest ograniczony przez kontrolę rodzicielską systemu Windows.
    451 Unavailable For Legal ReasonsDostęp do zasobu jest ograniczony z powodów prawnych.
    494 Request Header Too LargeNagłówek żądania jest zbyt duży, aby serwer mógł go przetworzyć.
    495 SSL Certificate ErrorCertyfikat SSL przedstawiony przez klienta jest nieważny.
    496 SSL Certificate RequiredWymagany jest ważny certyfikat SSL, aby uzyskać dostęp do tego zasobu.
    497 HTTP Request Sent to HTTPS PortKlient wysłał żądanie HTTP do portu tylko dla HTTPS.
    498 Invalid TokenToken podany w żądaniu jest nieważny lub wygasł.
    499 Client Closed RequestKlient zamknął połączenie przed otrzymaniem odpowiedzi serwera.
    Kody 5xx
    500 Internal Server ErrorWystąpił wewnętrzny błąd serwera, przetwarzanie żądania jest niemożliwe.
    501 Not ImplementedŻądanie nie może być przetworzone, ponieważ serwer nie obsługuje wymaganej funkcjonalności.
    502 Bad GatewaySerwer otrzymał nieprawidłową odpowiedź od innego serwera podczas przetwarzania żądania.
    503 Service UnavailableSerwer jest tymczasowo niedostępny z powodu przeciążenia lub konserwacji.
    504 Gateway Time-outPrzekroczono limit czasu oczekiwania na odpowiedź od innego serwera lub bramy.
    505 HTTP Version not supportedWersja HTTP używana nie jest obsługiwana przez serwer.
    506 Variant Also NegotiatesBłąd konfiguracji serwera, wybór wariantu również bierze udział w negocjacjach.
    507 Insufficient StorageSerwer nie może ukończyć żądania z powodu braku pamięci lub miejsca na dysku.
    508 Loop DetectedWykryto nieskończoną pętlę podczas przetwarzania żądania.
    509 Bandwidth Limit ExceededPrzekroczono limit pasma serwera.
    510 Not ExtendedŻądanie wymaga dodatkowych rozszerzeń, które nie są obsługiwane przez serwer.
    511 Network Authentication RequiredWymagana jest autoryzacja sieciowa, aby uzyskać dostęp do zasobu.
    520 Unknown ErrorNieznany błąd serwera.
    521 Web Server Is DownSerwer WWW jest niedostępny.
    522 Connection Timed OutPrzekroczono limit czasu połączenia.
    523 Origin Is UnreachableŹródło zasobu jest niedostępne.
    524 A Timeout OccurredPrzekroczono limit czasu żądania.
    525 SSL Handshake FailedNiepowodzenie w nawiązaniu połączenia SSL.
    526 Invalid SSL CertificateNieprawidłowy certyfikat SSL.
    527 Railgun ErrorBłąd połączenia przez Railgun.
    529 Site is overloadedStrona jest przeciążona żądaniami.
    530 Site is frozenStrona jest zablokowana i niedostępna.
    530 Origin DNS ErrorBłąd DNS po stronie źródła.
    540 Temporarily DisabledSerwer jest tymczasowo wyłączony.
    598 Network read timeout errorBłąd odczytu sieciowego z powodu przekroczenia limitu czasu.
    599 Network Connect Timeout ErrorBłąd połączenia z powodu przekroczenia limitu czasu.
    Inne
    783 Unexpected Token (Shopify)Nieoczekiwany token w żądaniu Shopify.
    999 Non-standardKod błędu niestandardowy.

    Ogólne informacje o kodach statusu HTTP

    Kody statusu HTTP to 3-cyfrowe liczby, które serwer internetowy zwraca jako odpowiedź na żądanie klienta. Te kody informują o stanie przetwarzania żądania i pomagają w diagnozowaniu problemów. Kody statusu są kluczowe dla komunikacji między klientem a serwerem, a ich zrozumienie jest niezbędne dla programistów i administratorów systemów.

    1xx: Kody informacyjne

    Grupa kodów informacyjnych wskazuje, że żądanie zostało odebrane przez serwer, ale wymaga dalszej obróbki. Kody te informują klienta o postępie przetwarzania żądania.

    • 100 Continue - Klient powinien kontynuować wysyłanie żądania.
    • 101 Switching Protocols - Serwer zgadza się na przełączenie protokołów, jak żądano przez klienta.

    2xx: Kody sukcesu

    Kody sukcesu oznaczają, że żądanie zostało pomyślnie przetworzone przez serwer. Oto kilka przykładów:

    • 200 OK - Żądanie zakończyło się powodzeniem, a odpowiedź zawiera żądane dane.
    • 201 Created - Żądanie zakończyło się powodzeniem, a nowy zasób został utworzony.
    • 204 No Content - Żądanie zakończyło się powodzeniem, ale nie ma danych do zwrócenia.

    3xx: Kody przekierowań

    Kody przekierowań informują klienta, że żądanie musi zostać przekierowane do innego zasobu. Przykłady kodów z tej grupy to:

    • 301 Moved Permanently - Zasób został trwale przeniesiony na nowy adres URL.
    • 302 Found - Zasób został tymczasowo przeniesiony na inny adres URL.
    • 304 Not Modified - Zasób nie został zmieniony od ostatniego żądania.

    4xx: Błędy klienta

    Kody błędów klienta wskazują, że wystąpił problem z żądaniem wysłanym przez klienta. Oto niektóre z nich:

    • 400 Bad Request - Serwer nie może przetworzyć żądania z powodu błędu klienta.
    • 401 Unauthorized - Klient nie ma uprawnień do dostępu do zasobu.
    • 404 Not Found - Żądany zasób nie został znaleziony na serwerze.

    5xx: Błędy serwera

    Kody błędów serwera oznaczają, że serwer napotkał problem podczas przetwarzania żądania. Przykłady kodów błędów serwera to:

    • 500 Internal Server Error - Ogólny błąd serwera, który nie pozwala na przetworzenie żądania.
    • 502 Bad Gateway - Serwer działa jako brama lub serwer proxy i otrzymał nieprawidłową odpowiedź od innego serwera.
    • 503 Service Unavailable - Serwer jest tymczasowo niedostępny, zazwyczaj z powodu przeciążenia.

    Kody statusu w praktyce

    Kody statusu HTTP są nieodłącznym elementem procesu tworzenia aplikacji internetowych. Oto kilka wskazówek dotyczących ich wykorzystania:

    1. Dokumentacja - Używaj odpowiednich kodów statusu w dokumentacji API, aby użytkownicy wiedzieli, czego się spodziewać.
    2. Obsługa błędów - Implementuj logikę obsługi błędów, aby odpowiednio reagować na różne kody statusu, co poprawi doświadczenie użytkowników.
    3. Testowanie - Regularnie testuj aplikację pod kątem różnych kodów statusu, aby upewnić się, że wszystkie scenariusze są prawidłowo obsługiwane.
    Kod Opis
    200 OK - Żądanie zakończone pomyślnie
    404 Not Found - Zasób nie został znaleziony
    500 Internal Server Error - Błąd wewnętrzny serwera