W tym artykule
Czym są kody statusu HTTP?
Kody statusu HTTP to trzycyfrowe liczby zwracane przez serwery internetowe w odpowiedzi na żądanie klienta. Wskazują, czy żądanie zakończyło się sukcesem, zostało przekierowane, spowodowało błąd lub wymaga dalszych działań. Za każdym razem, gdy ładujesz stronę internetową, Twoja przeglądarka otrzymuje jeden z tych kodów.
Kody statusu są zdefiniowane przez specyfikację HTTP (RFC 7231 i powiązane RFC) i pogrupowane w pięć klas na podstawie pierwszej cyfry. Zrozumienie tych kodów jest niezbędne dla programistów web, projektantów API i każdego, kto debuguje aplikacje internetowe.
Pięć kategorii kodów statusu
Kody statusu HTTP są zorganizowane w pięć kategorii, z których każda wskazuje inny typ odpowiedzi.
- 1xx Informacyjne — żądanie zostało odebrane i przetwarzanie trwa (np. 100 Continue, 101 Switching Protocols)
- 2xx Sukces — żądanie zostało pomyślnie odebrane, zrozumiane i zaakceptowane (np. 200 OK, 201 Created, 204 No Content)
- 3xx Przekierowanie — wymagane jest dalsze działanie w celu ukończenia żądania (np. 301 Moved Permanently, 302 Found, 304 Not Modified)
- 4xx Błąd klienta — żądanie zawiera nieprawidłową składnię lub nie może zostać zrealizowane (np. 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found)
- 5xx Błąd serwera — serwer nie mógł zrealizować prawidłowego żądania (np. 500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable)
Wypróbuj za darmo — bez rejestracji
Sprawdź kody statusu →Kiedy korzystać z przewodnika po kodach statusu HTTP
Znajomość właściwego kodu statusu do zwrócenia lub oczekiwania jest kluczowa dla budowania niezawodnych usług internetowych.
- Rozwój API — wybierz odpowiedni kod odpowiedzi dla każdego endpointu (201 dla tworzenia, 204 dla usuwania, 422 dla błędów walidacji)
- Debugowanie — diagnozuj problemy, gdy żądania się nie powiodą (czy to problem uwierzytelniania 401, czy autoryzacji 403?)
- SEO i monitoring — śledź przekierowania 301/302, identyfikuj uszkodzone linki 404 i monitoruj błędy serwera 5xx
Często zadawane pytania
Jaka jest różnica między 401 a 403?
401 Unauthorized oznacza, że klient nie podał prawidłowych danych uwierzytelniających — użytkownik musi się zalogować lub podać klucz API. 403 Forbidden oznacza, że klient jest uwierzytelniony, ale nie ma uprawnień dostępu do zasobu. W skrócie: 401 = „kim jesteś?”, 403 = „wiem, kim jesteś, ale nie masz dostępu”.
Kiedy używać przekierowania 301 a kiedy 302?
Użyj 301 Moved Permanently, gdy zasób został na stałe przeniesiony pod nowy adres URL — wyszukiwarki zaktualizują swój indeks. Użyj 302 Found (lub 307 Temporary Redirect), gdy przekierowanie jest tymczasowe i oryginalny adres URL powinien nadal być używany w przyszłości. Użycie nieprawidłowego kodu może zaszkodzić SEO.
Co oznacza błąd 500 Internal Server Error?
Błąd 500 to ogólny błąd po stronie serwera wskazujący, że coś poszło nie tak podczas przetwarzania żądania, ale serwer nie może być bardziej szczegółowy. Typowe przyczyny obejmują nieobsłużone wyjątki w kodzie aplikacji, awarie połączenia z bazą danych, nieprawidłowo skonfigurowane serwery lub problemy z wdrożeniem. Sprawdź logi serwera, aby uzyskać szczegóły błędu.