Czym jest Wyszukiwarka Kodów Stanu HTTP?
Kody statusu HTTP to trzycyfrowe liczby, które serwer WWW odsyła wraz z każdą odpowiedzią, informując klienta (przeglądarkę, aplikację lub użytkownika interfejsu API), czy żądanie się powiodło, wymaga przekierowania czy nie powiodło się — i dlaczego. Są one standaryzowane przez IETF i używane w identyczny sposób w każdym serwerze WWW, przeglądarce i języku programowania, co czyni je jednym z najbardziej uniwersalnych narzędzi do debugowania w tworzeniu oprogramowania.
Ta wyszukiwarka obejmuje najczęściej spotykane kody ze wszystkich pięciu kategorii — informacyjne (1xx), sukces (2xx), przekierowania (3xx), błędy klienta (4xx) i błędy serwera (5xx) — z prostym wyjaśnieniem, co każdy z nich faktycznie oznacza w praktyce, a nie tylko formalną definicją RFC.
Kiedy używać tego kalkulatora
- Debugowanie integracji API, w której żądanie zawodzi i trzeba zrozumieć, co kod statusu faktycznie oznacza
- Decydowanie, który kod statusu HTTP zwrócić ze swojego API dla konkretnego stanu błędu
- Nauczanie lub nauka podstaw HTTP na kursie lub bootcampie tworzenia stron internetowych
- Pisanie middleware obsługi błędów, które musi rozróżniać poszczególne przypadki 4xx i 5xx
- Badanie, dlaczego przekierowanie nie działa, przez sprawdzenie, czy zwrócono 301, czy 302
- Rozwiązywanie problemów z CORS, gdy przeglądarka pokazuje błąd sieci, a serwer zwrócił 200
Kroki:
- Wpisz kod statusu (np. 404) lub słowo kluczowe (np. "forbidden") w polu wyszukiwania.
- Filtruj według kategorii za pomocą przycisków 1xx-5xx, jeśli chcesz przeglądać określony zakres.
- Przeczytaj proste wyjaśnienie, co oznacza kod i kiedy jest zwykle zwracany.
- Używaj tego jako szybkiego odniesienia podczas debugowania odpowiedzi API lub tworzenia obsługi błędów.
Wzór
1xx: Informacyjne — żądanie otrzymane, proces kontynuowany
2xx: Sukces — żądanie zostało poprawnie otrzymane i zaakceptowane
3xx: Przekierowanie — potrzebne dalsze działania, aby ukończyć żądanie
4xx: Błąd klienta — żądanie zawiera błędną składnię lub nie może zostać zrealizowane
5xx: Błąd serwera — serwer nie zdołał zrealizować prawidłowego żądania
Przypadki użycia
- Szybkie zrozumienie nieznanego kodu statusu zwracanego przez API, z którym się integrujesz
- Decydowanie, który kod statusu zwrócić ze swojego API w danym stanie błędu
- Debugowanie, dlaczego żądanie zawodzi, przez sprawdzenie, co konkretny kod faktycznie oznacza
- Nauczanie lub nauka podstaw HTTP na kursie tworzenia stron internetowych
- Pisanie precyzyjnej logiki obsługi błędów rozróżniającej poszczególne przypadki 4xx i 5xx
Kluczowe korzyści
- Każdy powszechnie używany kod statusu w jednym przeszukiwalnym zasobie
- Proste wyjaśnienia, nie tylko formalna terminologia RFC
- Natychmiastowe filtrowanie według kategorii (od 1xx do 5xx)
- Bezpłatnie, szybko, bez rejestracji
Wskazówki
- Zarezerwuj kody 5xx wyłącznie dla błędów po stronie serwera — nigdy nie używaj ich do sygnalizowania błędów danych wejściowych klienta
- Używaj 429 z nagłówkiem Retry-After przy ograniczaniu tempa, aby dobrze napisane klienty wiedziały, kiedy ponowić próbę
- Preferuj 404 zamiast ogólnej strony błędu, gdy zasób naprawdę nie istnieje — to lepsze dla użytkowników i wyszukiwarek
- Projektując API, wybieraj konkretne kody 4xx (422, 409, 400) zamiast domyślnie używać ogólnego 400 do wszystkiego
Częste błędy
- Zwracanie 200 OK dla żądania, które faktycznie nie powiodło się, ukrywając błędy przed narzędziami monitorującymi
- Mylenie 401 (brak uwierzytelnienia) z 403 (uwierzytelniony, ale bez uprawnień)
- Używanie 302 do przekierowania, które powinno być stałe (301), co szkodzi SEO
- Traktowanie wszystkich błędów 4xx i 5xx tak samo w obsłudze błędów po stronie klienta zamiast rozgałęziania na konkretny kod
Kluczowe pojęcia
- Wiersz statusu: Pierwsza linia odpowiedzi HTTP zawierająca kod statusu i krótką frazę wyjaśniającą
- Idempotencja: Właściwość niektórych metod HTTP, w której powtórzenie tego samego żądania ma taki sam skutek jak wykonanie go raz
- Łańcuch przekierowań: Sekwencja wielu przekierowań, które przeglądarka podąża, zanim dotrze do końcowego zasobu
- Ograniczanie tempa: Ograniczanie liczby żądań, jakie klient może wysłać w danym oknie czasowym, często sygnalizowane kodem 429
Powiązane pojęcia
- Formatowanie JSON
- Walidator JSON
- Tester wyrażeń regularnych
- Koder/dekoder URL
- Koder/dekoder Base64
Przykład
Wyszukanie "429" zwraca "Too Many Requests" — kod, który interfejsy API zwracają po przekroczeniu limitu żądań, informujący, aby zwolnić i ponowić próbę po opóźnieniu.
Interpretacja wyników
Kody statusu HTTP są pogrupowane w pięć klas według pierwszej cyfry. 1xx mają charakter informacyjny i rzadko pojawiają się w kodzie aplikacji. 2xx potwierdza sukces — 200 OK jest najczęstsze, ale 201 Created i 204 No Content również występują często w interfejsach REST. 3xx obsługuje przekierowania, z czego najważniejsze to 301 (stałe) i 302 (tymczasowe).
Błędy 4xx wskazują, że coś jest nie tak z żądaniem klienta. Najczęstsze to 400 Bad Request (błędna składnia), 401 Unauthorized (brak uwierzytelnienia), 403 Forbidden (brak uprawnień), 404 Not Found (zasób nie istnieje) i 429 Too Many Requests (przekroczony limit żądań). Prawidłowe stosowanie konkretnych kodów 4xx czyni Twoje API znacznie łatwiejszym do debugowania niż zwracanie ogólnego 400 dla wszystkiego.
Błędy 5xx oznaczają, że zawiódł serwer. 500 to ogólny błąd wewnętrzny, 502 Bad Gateway wskazuje na problem z serwerem nadrzędnym, a 503 Service Unavailable zwykle oznacza przeciążenie serwera lub jego przerwę na konserwację. Podczas debugowania błędów 5xx sprawdzaj logi serwera, a nie odpowiedź po stronie klienta, ponieważ sam kod statusu rzadko ujawnia przyczynę źródłową.