Dla programistów

Kody statusu HTTP: pełna lista i znaczenie

Przeszukiwalna ściąga z kodami statusu HTTP: co oznacza każdy z nich, jego typowa przyczyna i wpływ na SEO.

Dostępne również w:EnglishEspañolPortuguêsFrançaisDeutschItalianoNederlands

100

Continue

Serwer otrzymał nagłówki żądania, a klient powinien wysłać treść.

101

Switching Protocols

Serwer zmienia protokół zgodnie z żądaniem, najczęściej na WebSocket.

200

OK

Standardowa odpowiedź sukcesu. Treść zawiera żądany zasób.

201

Created

Żądanie powiodło się i utworzono nowy zasób. Jego adres zwraca się w nagłówku Location.

202

Accepted

Żądanie zostało przyjęte do przetworzenia, ale jeszcze się nie zakończyło. Częste w zadaniach asynchronicznych.

204

No Content

Sukces bez treści do zwrócenia. Powszechnie używane dla DELETE i aktualizacji PUT.

206

Partial Content

Serwer zwraca część zasobu w odpowiedzi na nagłówek Range, jak przy strumieniowaniu wideo.

301

Moved Permanently

Zasób trwale się przeniósł. Przenosi sygnały rankingowe na nowy adres URL: to właściwe przekierowanie dla trwałej zmiany.

302

Found

Przekierowanie tymczasowe. Wyszukiwarki zachowują w indeksie oryginalny adres URL, więc nigdy nie używaj go do trwałej zmiany.

304

Not Modified

Kopia w pamięci podręcznej jest wciąż aktualna. Wysyłane w odpowiedzi na żądanie warunkowe, oszczędza przepustowość.

307

Temporary Redirect

Jak 302, ale gwarantuje, że metoda HTTP nie zmienia się przy przekierowaniu.

308

Permanent Redirect

Jak 301, ale zachowuje metodę i treść żądania.

400

Bad Request

Serwer nie mógł przetworzyć żądania. Zwykle błędnie sformatowany JSON albo brak wymaganego parametru.

401

Unauthorized

Brak uwierzytelnienia albo jest ono nieprawidłowe. Mimo nazwy dotyczy to uwierzytelniania, a nie uprawnień.

403

Forbidden

Tożsamość jest znana, ale nie ma uprawnień do tej czynności. Ponowna próba z tymi samymi danymi logowania nic nie da.

404

Not Found

Pod tym adresem URL nie ma zasobu. Musi zwracać prawdziwy status 404: strona „nie znaleziono” zwracająca 200 to miękki (soft) 404.

405

Method Not Allowed

Adres URL istnieje, ale nie akceptuje tej metody HTTP. Dodaj nagłówek Allow z listą akceptowanych metod.

409

Conflict

Żądanie jest w konflikcie z bieżącym stanem, na przykład zduplikowany unikalny klucz albo nieaktualna wersja.

410

Gone

Celowo i trwale usunięte. Wyszukiwarki usuwają z indeksu adres 410 szybciej niż 404.

418

I'm a teapot

Żart primaaprilisowy z 1998 roku, który przeglądarki i serwery podtrzymują do dziś.

422

Unprocessable Content

Składnia jest poprawna, ale treść nie przechodzi reguł walidacji. Częste w API JSON.

429

Too Many Requests

Przekroczono limit żądań. Dodaj nagłówek Retry-After, żeby klient wiedział, kiedy spróbować ponownie.

500

Internal Server Error

Nieobsłużony wyjątek na serwerze. Kod uniwersalny, gdy żaden bardziej szczegółowy nie pasuje.

502

Bad Gateway

Serwer proxy otrzymał nieprawidłową odpowiedź z serwera źródłowego. Zwykle aplikacja jest niedostępna albo się wywraca.

503

Service Unavailable

Tymczasowe przeciążenie albo przerwa techniczna. Właściwy kod dla planowanej niedostępności, razem z nagłówkiem Retry-After.

504

Gateway Timeout

Serwer proxy zbyt długo czekał na odpowiedź z serwera źródłowego. Wskazuje na wolne zapytanie albo zawieszoną zależność.

Wszystko liczy się w twojej przeglądarce. To, co wpisujesz, nie trafia na żaden serwer.

Kody statusu HTTP: do czego służy

Kody statusu HTTP mówią o wiele więcej, niż wykorzystuje większość API. Różnica między 301 a 302 decyduje o tym, czy sygnały SEO zostają przeniesione, a ta między 401 a 403 rozdziela uwierzytelnianie od autoryzacji. Ta przeszukiwalna ściąga obejmuje standardowe kody z ich praktycznymi konsekwencjami.

Kody statusu HTTP: jak korzystać

  1. Wyszukaj po numerze kodu albo po słowie kluczowym.
  2. Filtruj według klasy: 2xx sukces, 3xx przekierowanie, 4xx błąd klienta, 5xx błąd serwera.
  3. Przeczytaj znaczenie i typową przyczynę.
  4. Zwróć uwagę na przekierowania i błędy wpływające na indeksowanie.

Najczęściej zadawane pytania

Jaka jest różnica między przekierowaniem 301 a 302?

301 jest trwałe i przenosi sygnały SEO na nowy adres URL; 302 jest tymczasowe i mówi wyszukiwarkom, żeby zachowały w indeksie oryginalny adres. Użycie 302 dla trwałej zmiany to częsty i kosztowny błąd.

Kiedy zwrócić 404, a kiedy 410?

404 oznacza „nie znaleziono”, być może tymczasowo. 410 wskazuje, że zasób został celowo i trwale usunięty, a wyszukiwarki zwykle usuwają go z indeksu szybciej.

Czym jest miękki 404?

Strona, która mówi użytkownikowi „nie znaleziono”, ale zwraca kod 200. Wyszukiwarki indeksują ją jak prawdziwą stronę, marnując budżet indeksowania. Aplikacje jednostronicowe generują je bardzo łatwo.

Jaka jest różnica między 401 a 403?

401 oznacza, że nie zostałeś uwierzytelniony, więc podanie danych logowania mogłoby pomóc. 403 oznacza, że jesteś uwierzytelniony, ale nie masz uprawnień, i ponowna próba z tą samą tożsamością nic nie da.