Kody odpowiedzi HTTP

Serwer zaakceptował nagłówki żądania i czeka na pozostałą treść żądania. Kod jest często używany z Expect: 100-continue, aby klient mógł uniknąć wysyłania dużej treści, jeśli żądanie zostanie odrzucone.

Wskazówki operacyjne: Odpowiedź pośrednia; wysyłaj dalszą treść tylko wtedy, gdy jest oczekiwana.

Serwer zgadza się zmienić protokół dla tego połączenia po otrzymaniu żądania aktualizacji od klienta. Typowym zastosowaniem jest uzgadnianie połączenia WebSocket.

Wskazówki operacyjne: Zmiana na poziomie połączenia; sprawdź nagłówki Upgrade i Connection.

Serwer WebDAV informuje, że rozpoczęła się długotrwała operacja, która jeszcze się nie zakończyła. To przestarzała odpowiedź; nie należy jej mylić z wynikiem końcowym.

Wskazówki operacyjne: Pośredni status WebDAV; poczekaj na odpowiedź końcową.

Podczas przygotowywania odpowiedzi końcowej serwer wysyła wstępne nagłówki, często wskazówki Link. Klient może wcześniej rozpocząć pobieranie prawdopodobnie istotnych zasobów.

Wskazówki operacyjne: Optymalizacja pośrednia; musi po niej nadejść odpowiedź końcowa.

Żądanie zakończyło się powodzeniem. Reprezentacja zależy od metody: GET zwraca zasób, HEAD zwraca metadane bez treści, a operacja zapisu może zwrócić reprezentację wyniku.

Wskazówki operacyjne: Używaj dla zakończonego żądania, gdy odpowiednia jest reprezentacja odpowiedzi.

Żądanie zostało wykonane i utworzyło co najmniej jeden zasób. Odpowiedź powinna wskazywać nowy zasób, zwykle za pomocą nagłówka Location, i może zawierać jego reprezentację.

Wskazówki operacyjne: Typowe po POST lub PUT; upewnij się, że można zlokalizować utworzony zasób.

Serwer przyjął żądanie do przetwarzania, ale proces nie został zakończony i nadal może się nie powieść. HTTP nie dostarcza później drugiej odpowiedzi w ramach tej samej wymiany.

Wskazówki operacyjne: Udostępnij adres URL operacji/statusu lub inny sposób sprawdzenia końcowego wyniku.

Transformujący serwer proxy lub pośrednik zwrócił metadane albo treść różniącą się od odpowiedzi źródłowej. Oznacza to, że odpowiedź nie jest bezpośrednią, autorytatywną reprezentacją.

Wskazówki operacyjne: Używaj tylko wtedy, gdy transformacja pośrednika ma znaczenie.

Żądanie zakończyło się powodzeniem i nie ma treści do odesłania. Nagłówki nadal mogą zawierać przydatne metadane, na przykład zaktualizowane walidatory.

Wskazówki operacyjne: Nie dołączaj treści odpowiedzi.

Żądanie zakończyło się powodzeniem, a klient otrzymuje polecenie zresetowania widoku lub formularza, z którego je wysłano. Odpowiedź nie zawiera treści.

Wskazówki operacyjne: Przydatny w interakcjach, które powinny wyczyścić lub zresetować bieżące dane wejściowe.

Serwer obsłużył prawidłowe żądanie zakresu i zwraca wyłącznie żądany zakres lub zakresy bajtów. Nagłówek Content-Range opisuje przesłane dane.

Wskazówki operacyjne: Upewnij się, że wartości zakresu i Content-Range są zgodne; rozwiązanie jest często stosowane przy wznawianiu pobierania multimediów i plików.

Odpowiedź WebDAV przedstawia osobne wyniki dla wielu zasobów lub podoperacji, zwykle w ustrukturyzowanej treści XML.

Wskazówki operacyjne: Analizuj wynik każdego osadzonego zasobu; sam zewnętrzny kod statusu nie przedstawia pełnego rezultatu.

Odpowiedź WebDAV typu multistatus pomija elementy wymienione już wcześniej w tej samej odpowiedzi, aby ich nie powtarzać.

Wskazówki operacyjne: Kod specyficzny dla WebDAV; interpretuj go razem z otaczającą odpowiedzią multistatus.

Serwer obsłużył żądanie GET z użyciem manipulacji instancją i zwraca reprezentację utworzoną z bieżącego zasobu zgodnie z uzgodnionym mechanizmem różnic.

Wskazówki operacyjne: Wyspecjalizowane kodowanie różnicowe; klient i serwer muszą uzgodnić transformację.

Zasób ma kilka reprezentacji lub miejsc docelowych, a odpowiedź przedstawia dostępne opcje. Klient lub użytkownik może wybrać preferowany wariant.

Wskazówki operacyjne: Przedstaw czytelne alternatywy; nie zakładaj, że każdy klient dokona wyboru automatycznie.

Zasób ma nowy, trwały URI. Klienci mogą zaktualizować zapisane odnośniki i pamięć podręczną, dlatego używaj tego kodu tylko wtedy, gdy przeniesienie ma być stałe.

Wskazówki operacyjne: Przy migracji SEO przekieruj bezpośrednio do końcowego, równoważnego adresu URL i zaktualizuj odnośniki wewnętrzne.

Zasób jest tymczasowo dostępny pod innym URI. Historyczne zachowanie dopuszcza w niektórych przypadkach zmianę metody, dlatego nie jest to najbezpieczniejszy wybór, jeśli POST musi pozostać POST.

Wskazówki operacyjne: Używaj przy tymczasowych przeniesieniach, gdy zmiana metody jest dopuszczalna; w przeciwnym razie rozważ 307.

Klient powinien pobrać zasób wskazany przez Location metodą GET (lub odpowiednio HEAD), zamiast powtarzać pierwotną czynność. Kod jest często stosowany po wysłaniu formularza.

Wskazówki operacyjne: Realizuje wzorzec Post/Redirect/Get i zapobiega ponownemu wysłaniu tej samej czynności.

Warunkowe żądanie GET lub HEAD wskazuje, że reprezentacja w pamięci podręcznej jest nadal aktualna. Odpowiedź nie zawiera treści, dzięki czemu klient może ponownie użyć zapisanej kopii.

Wskazówki operacyjne: Zwracaj tylko wtedy, gdy pasuje walidator, taki jak If-None-Match lub If-Modified-Since.

Historyczna odpowiedź proponowała klientowi dostęp do zasobu przez serwer proxy. Została wycofana ze względów bezpieczeństwa i nie powinna być używana przez współczesne usługi.

Wskazówki operacyjne: Nie wdrażaj; konfiguruj serwery proxy poza pasmem.

Ta wartość jest zarezerwowana lub nieużywana we współczesnych specyfikacjach HTTP. Nie ma standardowego znaczenia operacyjnego dla aktualnej aplikacji internetowej.

Wskazówki operacyjne: Nie wysyłaj tego kodu.

Zasób znajduje się tymczasowo pod innym URI, a klient musi zachować pierwotną metodę i treść żądania podczas przekierowania.

Wskazówki operacyjne: Użyj, gdy tymczasowa zmiana adresu nie może zmienić POST na GET.

Zasób został przeniesiony na stałe, a klient musi zachować pierwotną metodę i treść żądania podczas przekierowania.

Wskazówki operacyjne: Użyj przy trwałym przeniesieniu, gdy zachowanie metody ma znaczenie; zaktualizuj odnośniki canonical i wewnętrzne.

Serwer nie może przetworzyć żądania, ponieważ jego składnia, format ramkowania lub przekazane dane są nieprawidłowe. Ponowne wysłanie niezmienionego żądania prawdopodobnie nie pomoże.

Wskazówki operacyjne: Sprawdź kodowanie URL, składnię JSON lub treści, wymagane pola i format ramkowania żądania.

Żądanie nie zawiera prawidłowych danych uwierzytelniających wymaganych przez serwer docelowy. Pomimo nazwy kod oznacza, że uwierzytelnienie jest wymagane lub nie powiodło się.

Wskazówki operacyjne: Prześlij wymagane dane uwierzytelniające i dołącz wyzwanie WWW-Authenticate.

Kod zarezerwowany do przyszłego użytku, choć niektóre produkty stosują go do obsługi płatności lub limitów. Nie istnieje jedno powszechnie interoperacyjne zachowanie związane z płatnością.

Wskazówki operacyjne: Traktuj znaczenia specyficzne dla dostawcy jako takie i opisz kontrakt API.

Serwer zrozumiał żądanie, ale odmawia jego wykonania. Prawidłowe dane uwierzytelniające nie muszą zmienić wyniku, ponieważ ograniczenie może wynikać z zasad dostępu.

Wskazówki operacyjne: Sprawdź uprawnienia, zasady dostępu, reguły IP/WAF i autoryzację na poziomie zasobu.

Serwer nie może znaleźć aktualnej reprezentacji dla żądanego URI albo nie chce ujawnić, czy ona istnieje. Sama odpowiedź nie wskazuje, czy brak jest tymczasowy, czy trwały.

Wskazówki operacyjne: Popraw adres URL, przywróć zasób albo użyj 410, gdy wiadomo, że został usunięty na stałe.

Zasób istnieje, ale nie obsługuje metody użytej w tym żądaniu.

Wskazówki operacyjne: Zwróć nagłówek Allow z listą metod akceptowanych przez zasób.

Serwer nie może utworzyć reprezentacji zgodnej z preferencjami Accept określonymi przez klienta.

Wskazówki operacyjne: Złagodź warunki Accept lub skonfiguruj odpowiednią reprezentację i zasady negocjacji treści.

Pośredniczący serwer proxy wymaga danych uwierzytelniających, zanim przekaże żądanie dalej.

Wskazówki operacyjne: Uwierzytelnij się wobec proxy za pomocą Proxy-Authenticate / Proxy-Authorization; różni się to od uwierzytelniania wobec serwera źródłowego.

Serwer nie otrzymał kompletnego żądania w czasie, w którym był gotów na nie czekać. Klient może ponowić próbę w nowym połączeniu.

Wskazówki operacyjne: Sprawdź przerwy w transmisji, rozmiar przesyłanych danych oraz limity czasu serwera i proxy.

Żądanie jest sprzeczne z bieżącym stanem zasobu, na przykład z powodu kolizji wersji lub próby utworzenia duplikatu.

Wskazówki operacyjne: Opisz konflikt i przekaż klientowi wystarczające informacje o aktualnym stanie, aby mógł go rozwiązać.

Zasób został celowo i prawdopodobnie trwale wycofany, bez znanego zamiennika. To silniejszy sygnał niż ogólna odpowiedź o nieodnalezieniu zasobu.

Wskazówki operacyjne: Używaj, gdy usunięcie jest zamierzone; usuń nieaktualne odnośniki wewnętrzne i inne wskazania.

Serwer wymaga nagłówka Content-Length, którego nie podano w żądaniu.

Wskazówki operacyjne: Prześlij prawidłową wartość Content-Length lub użyj obsługiwanego sposobu ramkowania transmisji.

Warunek żądania, taki jak If-Match, został oceniony jako fałszywy, dlatego serwer nie wykonał żądanej czynności.

Wskazówki operacyjne: Odśwież reprezentację i ponów próbę z aktualnymi walidatorami lub stanem.

Treść żądania przekracza limit, który serwer może lub chce przetworzyć. Serwer może zamknąć połączenie albo zezwolić na ponowienie po zmniejszeniu treści.

Wskazówki operacyjne: Zmniejsz rozmiar danych albo dostosuj udokumentowane limity przesyłania.

Docelowy adres żądania jest dłuższy, niż serwer może lub chce obsłużyć; często przyczyną jest zbyt długi ciąg zapytania.

Wskazówki operacyjne: Użyj krótszego URI lub przenieś odpowiednie dane do treści żądania.

Serwer odrzuca treść żądania, ponieważ jej typ mediów, kodowanie lub sprawdzany format nie jest obsługiwany.

Wskazówki operacyjne: Wyślij obsługiwane Content-Type i kodowanie oraz zgodną z nimi treść.

Nie można obsłużyć żądanego zakresu bajtów, na przykład gdy jego początek wykracza poza długość reprezentacji.

Wskazówki operacyjne: Ponownie sprawdź długość zasobu i jednostki zakresu; serwer może zwrócić Content-Range: bytes */length.

Serwer lub pośrednik nie może spełnić oczekiwania określonego w nagłówku Expect.

Wskazówki operacyjne: Jeśli jest to bezpieczne i uzasadnione, ponów próbę bez nieobsługiwanego oczekiwania.

Żartobliwy kod pochodzący ze specyfikacji opublikowanej na prima aprilis. Nie jest standardową odpowiedzią błędu aplikacji, choć niektóre usługi używają go humorystycznie.

Wskazówki operacyjne: Nie polegaj na nim w interoperacyjnych systemach produkcyjnych.

Żądanie dotarło do serwera, który nie może zwrócić autorytatywnej odpowiedzi dla docelowego URI; często przyczyną jest niezgodność trasowania połączenia lub wartości authority protokołu HTTP.

Wskazówki operacyjne: Ponów próbę przez odpowiednie połączenie i sprawdź Host/:authority, SNI oraz trasowanie proxy.

Typ i składnia treści są zrozumiałe, ale serwer nie może wykonać zawartych w niej instrukcji ani zweryfikować przesłanej treści.

Wskazówki operacyjne: Zwracaj konkretne informacje o błędach walidacji pól; poprawienie przesłanych danych może umożliwić powodzenie.

Zasób WebDAV jest zablokowany, dlatego nie można wykonać żądanej metody do czasu rozwiązania problemu blokady.

Wskazówki operacyjne: Sprawdź właściciela blokady, czas jej wygaśnięcia i obsługę tokenu blokady WebDAV.

Operacja WebDAV nie powiodła się, ponieważ wcześniejsza, wymagana operacja w tej samej sekwencji żądań zakończyła się błędem.

Wskazówki operacyjne: Rozwiąż problem wcześniejszego nieudanego działania przed ponowieniem operacji zależnych.

Serwer odmawia przetworzenia żądania, które mogło zostać odtworzone podczas przesyłania wczesnych danych; ma to ograniczać ryzyko ponownego odtworzenia.

Wskazówki operacyjne: Ponów próbę po ustanowieniu połączenia, bez wysyłania wczesnych danych.

Serwer odrzuca bieżący protokół i wskazuje, że klient powinien przełączyć się na inny.

Wskazówki operacyjne: Dołącz nagłówek Upgrade opisujący obsługiwane protokoły.

Serwer wymaga warunkowego żądania, aby zapobiec utraconym aktualizacjom, ale klient wysłał żądanie bez warunku.

Wskazówki operacyjne: Pobierz bieżący stan i wyślij właściwy warunek, na przykład If-Match.

Klient wysłał zbyt wiele żądań w określonym czasie, zgodnie z limitem ustalonym przez serwer.

Wskazówki operacyjne: Ogranicz częstotliwość, uwzględnij Retry-After, jeśli występuje, i unikaj zsynchronizowanych serii ponowień.

Serwer nie przetworzy żądania, ponieważ jedno lub więcej pól nagłówka albo cały zestaw nagłówków jest zbyt duży.

Wskazówki operacyjne: Ogranicz pliki cookie lub niestandardowe nagłówki albo zmień celowo skonfigurowany limit serwera.

Serwer nie może udostępnić żądanego zasobu z powodu ograniczeń prawnych.

Wskazówki operacyjne: Jeśli to właściwe, wyjaśnij ograniczenie i jego zakres bez ujawniania informacji objętych ochroną.

Wystąpił nieoczekiwany stan serwera, który uniemożliwia ukończenie żądania. To ogólna odpowiedź zastępcza, stosowana, gdy nie pasuje dokładniejszy błąd serwera.

Wskazówki operacyjne: Powiąż żądanie z dziennikami serwera i nie ujawniaj odwiedzającym śladów stosu.

Serwer nie obsługuje funkcji wymaganej do wykonania żądania; najczęściej chodzi o nieobsługiwaną metodę lub możliwość.

Wskazówki operacyjne: Zaimplementuj tę funkcję lub użyj obsługiwanej metody; kod nie jest przeznaczony do sygnalizowania tymczasowego przeciążenia.

Serwer działający jako brama lub proxy otrzymał nieprawidłową odpowiedź od serwera nadrzędnego.

Wskazówki operacyjne: Sprawdź stan usług nadrzędnych, ustawienia protokołu i TLS, DNS oraz dzienniki proxy.

Serwer tymczasowo nie może obsłużyć żądania, często z powodu prac konserwacyjnych lub przeciążenia.

Wskazówki operacyjne: Jeśli to możliwe, zwróć Retry-After, pomocną treść i zasady buforowania odpowiednie dla tymczasowej awarii.

Brama lub serwer proxy nie otrzymały na czas odpowiedzi od usługi nadrzędnej.

Wskazówki operacyjne: Zbadaj opóźnienia usług nadrzędnych, trasy sieciowe i limity czasu w całym łańcuchu.

Serwer nie obsługuje głównej wersji HTTP użytej w żądaniu.

Wskazówki operacyjne: Użyj obsługiwanej wersji protokołu albo zaktualizuj konfigurację serwera lub proxy.

Błąd konfiguracji serwera utworzył cykliczną negocjację treści, w której wybrany wariant ponownie inicjuje negocjację.

Wskazówki operacyjne: Napraw konfigurację wariantu lub negocjacji treści; błąd znajduje się po stronie serwera źródłowego.

Serwer WebDAV nie może zapisać reprezentacji potrzebnej do ukończenia operacji.

Wskazówki operacyjne: Zwolnij lub zwiększ przestrzeń i sprawdź limity przed ponowieniem próby.

Serwer wykrył nieskończoną pętlę podczas obsługi żądania, często podczas przechodzenia przez powiązania WebDAV.

Wskazówki operacyjne: Przerwij cykliczną relację zasobów lub regułę przetwarzania.

Żądanie wymaga rozszerzenia, którego serwer nie obsługuje.

Wskazówki operacyjne: Użyj obsługiwanego zestawu rozszerzeń lub uzgodnij alternatywę.

Klient musi uwierzytelnić się, aby uzyskać dostęp do sieci, zwykle za pośrednictwem portalu przechwytującego. Kod dotyczy pośredników sieciowych, a nie logowania do witryny źródłowej.

Wskazówki operacyjne: Ukończ uwierzytelnianie dostępu do sieci, a następnie ponów pierwotne żądanie.

Niektóre aplikacje używają tej nazwy, gdy wygasa sesja uwierzytelniania. Nie jest to uniwersalnie przypisany status HTTP, dlatego klienty nie mogą zakładać jednolitej semantyki.

Wskazówki operacyjne: Odśwież uwierzytelnienie zgodnie z umową usługi.

Wartość specyficzna dla dostawcy, historycznie używana do ograniczania liczby żądań. Jej znaczenie określa dana implementacja.

Wskazówki operacyjne: Postępuj zgodnie z udokumentowanymi zaleceniami dotyczącymi limitów żądań.

Niektóre serwery zamykają połączenie bez wysłania typowej odpowiedzi, często w ramach filtrowania.

Wskazówki operacyjne: Sprawdź dzienniki dostawcy; klient może zgłosić błąd sieci zamiast wyświetlić ten kod.

Rozszerzenie firmy Microsoft używane przez niektóre usługi do żądania ponowienia próby przez klienta z dodatkowymi informacjami.

Wskazówki operacyjne: Postępuj zgodnie z dokumentacją konkretnego API.

Serwer proxy może zapisać ten kod, gdy klient rozłączy się przed zakończeniem odpowiedzi serwera nadrzędnego. Zazwyczaj jest to klasyfikacja w dzienniku, a nie odpowiedź dostarczona temu klientowi.

Wskazówki operacyjne: Sprawdź anulowania po stronie klienta i wolne żądania do serwera nadrzędnego.

Niektóre platformy hostingowe używają tego kodu dla limitu transferu lub przepustowości. Nie ma on ogólnego, interoperacyjnego znaczenia HTTP.

Wskazówki operacyjne: Sprawdź limity i ustawienia rozliczeń u dostawcy hostingu.

Usługa CDN lub proxy może zwrócić ten kod po otrzymaniu nieoczekiwanej albo pustej odpowiedzi serwera źródłowego.

Wskazówki operacyjne: Porównaj dzienniki węzła brzegowego i serwera źródłowego; sprawdź, czy serwer źródłowy zwraca prawidłową odpowiedź HTTP.

Serwer proxy nie mógł nawiązać połączenia z serwerem źródłowym albo serwer źródłowy je odrzucił.

Wskazówki operacyjne: Sprawdź dostępność serwera źródłowego, reguły zapory i listy dozwolonych połączeń proxy.

Usługa brzegowa nawiązała lub próbowała nawiązać połączenie z serwerem źródłowym, ale wymiana nie zakończyła się przed upływem limitu czasu.

Wskazówki operacyjne: Sprawdź szybkość odpowiedzi serwera źródłowego i opóźnienia sieci.

Serwer proxy nie mógł połączyć się ze skonfigurowanym adresem serwera źródłowego.

Wskazówki operacyjne: Sprawdź rozwiązywanie DNS, trasowanie i konfigurację adresu IP serwera źródłowego.

Połączenie z serwerem źródłowym zostało ustanowione, ale serwer nie wysłał odpowiedzi HTTP na czas.

Wskazówki operacyjne: Skróć czas przetwarzania po stronie serwera źródłowego lub dostosuj obsługiwane limity czasu.

Serwer proxy nie mógł ukończyć negocjacji TLS z serwerem źródłowym.

Wskazówki operacyjne: Sprawdź certyfikaty, zgodność protokołów i szyfrów oraz SNI.

Pośrednik odrzucił certyfikat serwera źródłowego podczas weryfikacji.

Wskazówki operacyjne: Zainstaluj prawidłowy, zaufany, niewygasły certyfikat z właściwą nazwą i pełnym łańcuchem.

Przestarzały lub specyficzny dla dostawcy status proxy wskazujący błąd połączenia przyspieszającego z serwerem źródłowym.

Wskazówki operacyjne: Sprawdź konektor specyficzny dla dostawcy i trasę do serwera źródłowego.

Niektóre klienty lub serwery proxy używają tej wartości do opisania przekroczenia czasu odczytu z sieci. Nie ma ona uniwersalnego znaczenia w HTTP.

Wskazówki operacyjne: Sprawdź diagnostykę klienta lub serwera proxy.

Niektóre serwery proxy używają tej wartości, gdy upłynie limit czasu próby połączenia sieciowego. Znaczenie zależy od implementacji.

Wskazówki operacyjne: Sprawdź osiągalność i ustawienia limitu czasu.