HTTP кодове на състоянието

Сървърът е приел заглавките на заявката и изчаква останалото тяло на заявката. Обикновено се използва с Expect: 100-continue, за да може клиентът да избегне качването на голямо тяло, когато заявката ще бъде отхвърлена.

Практически насоки: Междинен отговор; продължете изпращането на тялото само ако се очаква такова.

Сървърът се съгласява да смени протокола за тази връзка, след като клиентът поиска надграждане. Установяването на WebSocket връзка е често срещан пример.

Практически насоки: Промяна на ниво връзка; проверете заглавките Upgrade и Connection.

WebDAV сървър съобщава, че е започнала продължителна операция, която още не е приключила. Това е остарял/оттеглен от употреба отговор и не бива да се приема за крайния резултат.

Практически насоки: Междинен WebDAV код на състоянието; изчакайте крайния отговор.

Сървърът изпраща предварителни заглавки, често подсказки Link, докато подготвя крайния отговор. Клиентът може да започне по-рано да изтегля вероятно важни ресурси.

Практически насоки: Междинна оптимизация; след това трябва да последва краен отговор.

Заявката е успешна. Представянето зависи от метода: GET връща ресурса, HEAD връща метаданни без тяло, а операция за запис може да върне представяне на резултата.

Практически насоки: Използвайте при завършена заявка, когато е уместно да се върне представяне на отговора.

Заявката е завършена и е създала един или повече ресурси. Отговорът трябва да посочва новия ресурс, обикновено чрез Location, и може да върне негово представяне.

Практически насоки: Типичен отговор след POST или PUT; уверете се, че създаденият ресурс може да бъде намерен.

Сървърът е приел заявката за обработка, но обработката не е приключила и все още може да се провали. HTTP не изпраща по-късно втори отговор за същата комуникационна размяна.

Практически насоки: Предоставете URL адрес за състоянието на операцията или друг начин за проверка на крайния резултат.

Трансформиращ прокси сървър или междинна система е върнала метаданни или съдържание, различни от отговора на източника. Това показва, че отговорът не е пряко авторитетно представяне.

Практически насоки: Използвайте само когато трансформацията от междинна система е от значение.

Заявката е успешна и няма съдържание за изпращане в отговора. Заглавките все пак може да съдържат полезни метаданни, например актуализирани валидатори.

Практически насоки: Не включвайте тяло на отговора.

Заявката е успешна и клиентът трябва да нулира изгледа или формуляра, от който е изпратена. Не се изпраща съдържание в отговора.

Практически насоки: Полезно за действия, след които текущото състояние на въведените данни трябва да се изчисти или нулира.

Сървърът е изпълнил валидна заявка за диапазон и връща само поискан диапазон или диапазони от байтове. Content-Range описва изпратеното съдържание.

Практически насоки: Уверете се, че стойностите за Range и Content-Range съвпадат; често се използва при възобновяемо възпроизвеждане или изтегляне на мултимедия.

Отговорът на WebDAV отчита отделни резултати за множество ресурси или подоперации, обикновено в структурирано XML тяло.

Практически насоки: Тълкувайте резултата за всеки включен ресурс; външният код на състоянието сам по себе си не описва целия резултат.

Отговорът WebDAV multistatus пропуска елементи, които вече са изброени по-рано в същия отговор, за да не се повтарят.

Практически насоки: Специфично за WebDAV; тълкувайте заедно с обкръжаващия отговор multistatus.

Сървърът е изпълнил GET чрез манипулации на инстанцията и връща представяне, получено от текущия ресурс съгласно договорения механизъм за разлики.

Практически насоки: Специализирано кодиране на разлики; клиентът и сървърът трябва да са съгласни за трансформацията.

Целевият ресурс има няколко представяния или дестинации и отговорът предлага избор. Клиентът или потребителят може да избере предпочитания вариант.

Практически насоки: Посочете ясни алтернативи; не приемайте, че всеки клиент ще избере автоматично.

Ресурсът има нов постоянен URI адрес. Клиентите може да актуализират запазените връзки и кешове, затова използвайте този код само когато преместването трябва да остане постоянно.

Практически насоки: При SEO миграции пренасочвайте директно към крайния еквивалентен URL адрес и актуализирайте вътрешните връзки.

Ресурсът временно е достъпен на друг URI адрес. Историческото поведение позволява в някои случаи промяна на метода, затова това не е най-сигурният избор, когато POST трябва да остане POST.

Практически насоки: Използвайте при временно преместване, когато промяната на метода е приемлива; в противен случай обмислете 307.

Клиентът трябва да извлече ресурса, посочен в Location, чрез GET (или HEAD, когато е подходящо), вместо да повтаря първоначалното действие. Често се използва след изпращане на формуляр.

Практически насоки: Прилага модела Post/Redirect/Get и предотвратява повторното изпращане на действието.

Условна заявка GET или HEAD показва, че кешираното представяне все още е актуално. Отговорът няма тяло и позволява на клиента да използва отново съхраненото копие.

Практически насоки: Върнете този код само когато валидатор, като If-None-Match или If-Modified-Since, съвпада.

Исторически отговор, който предлага клиентът да достигне до ресурса чрез прокси сървър. Оттеглен е по съображения за сигурност и не бива да се използва от съвременни услуги.

Практически насоки: Не го внедрявайте; конфигурирайте прокси сървърите извън лентата на протокола.

Тази стойност е запазена/неизползвана в съвременните спецификации на HTTP. Няма стандартно оперативно значение за текущо уеб приложение.

Практически насоки: Не го изпращайте.

Ресурсът временно се намира на друг URI адрес; при следване на пренасочването клиентът трябва да запази първоначалния метод и тяло на заявката.

Практически насоки: Използвайте, когато временното преместване не бива да преобразува POST в GET.

Ресурсът е преместен за постоянно и при следване на пренасочването клиентът трябва да запази първоначалния метод и тяло на заявката.

Практически насоки: Използвайте при трайно преместване, когато запазването на метода е важно; актуализирайте каноничните адреси и вътрешните препратки.

Сървърът не може да обработи заявката, защото синтаксисът, рамкирането или предоставените данни са невалидни. Повтарянето на същата заявка без промени едва ли ще помогне.

Практически насоки: Проверете URL кодирането, синтаксиса на JSON/тялото, задължителните полета и рамкирането на заявката.

Заявката не съдържа валидни данни за удостоверяване към целевия ресурс. Въпреки името си, този отговор означава, че удостоверяване се изисква или е неуспешно.

Практически насоки: Изпратете очакваните данни за удостоверяване и включете предизвикателство WWW-Authenticate.

Запазен за бъдеща употреба, въпреки че някои продукти го използват при плащания или квоти. Няма единно поведение за плащане, съвместимо с всички системи.

Практически насоки: Третирайте специфичните за доставчика значения като такива и документирайте договора на API.

Сървърът е разбрал заявката, но отказва да я изпълни. Валидните данни за удостоверяване не е задължително да променят резултата, защото ограничението може да е наложено от политика.

Практически насоки: Проверете разрешенията, политиката за достъп, IP/WAF правилата и оторизацията на ниво ресурс.

Сървърът не може да намери текущо представяне за поисканото URI или не желае да разкрие, че такова съществува. Самият отговор не показва дали липсата е временна или постоянна.

Практически насоки: Поправете URL адреса, възстановете ресурса или използвайте 410, когато е известно, че премахването е постоянно.

Ресурсът съществува, но не поддържа използвания в тази заявка метод.

Практически насоки: Върнете заглавка Allow със списък на поддържаните от ресурса методи.

Сървърът не може да създаде представяне, което отговаря на предварителните предпочитания Accept на клиента.

Практически насоки: Облекчете ограниченията в Accept или конфигурирайте подходяща политика за представяне и договаряне на съдържание.

Междинен прокси сървър изисква удостоверяване, преди да препрати заявката.

Практически насоки: Удостоверете се пред прокси чрез Proxy-Authenticate / Proxy-Authorization; това е различно от удостоверяването пред изходния сървър.

Сървърът не е получил цялата заявка в рамките на времето, което е бил готов да изчака. Клиентът може да опита отново през нова връзка.

Практически насоки: Проверете прекъсванията на мрежата, размера на качваните данни и настройките за изчакване на сървъра/прокси.

Заявката противоречи на текущото състояние на ресурса, например при сблъсък на версии или опит за създаване на дубликат.

Практически насоки: Обяснете конфликта и предоставете достатъчно актуална информация, за да може клиентът да го разреши.

Ресурсът умишлено и вероятно трайно не е наличен и няма известен заместител. Този отговор е по-категоричен от общия отговор „не е намерен“.

Практически насоки: Използвайте при умишлено премахване; изтрийте остарелите вътрешни връзки и препратки.

Сървърът изисква заглавка Content-Length, но заявката не я съдържа.

Практически насоки: Изпратете точна стойност Content-Length или използвайте поддържан начин за рамкиране на предаването.

Условие на заявката, като If-Match, е оценено като невярно и затова сървърът не е извършил поисканото действие.

Практически насоки: Обновете представянето и опитайте отново с актуални валидатори/състояние.

Тялото на заявката надвишава ограничение, което сървърът може или желае да обработи. Сървърът може да затвори връзката или да позволи нов опит след намаляване на тялото.

Практически насоки: Намалете размера на данните или коригирайте документираните ограничения за качване.

Целта на заявката е по-дълга, отколкото сървърът може или желае да обработи; често причината е прекалено дълъг низ за заявка.

Практически насоки: Използвайте по-кратък URI адрес или преместете подходящите данни в тялото на заявката.

Сървърът отказва тялото на заявката, защото типът на носителя, кодирането на съдържанието или проверяваният формат не се поддържа.

Практически насоки: Изпратете поддържани Content-Type/кодиране и тяло, което им съответства.

Поисканият диапазон от байтове не може да бъде предоставен, например защото започва след края на представянето.

Практически насоки: Проверете отново дължината на ресурса и мерните единици на диапазона; сървърите може да върнат Content-Range: bytes */length.

Сървърът или междинната система не може да изпълни очакване, посочено в заглавката Expect.

Практически насоки: Опитайте отново без неподдържаното очакване, когато това е безопасно и подходящо.

Забавен код на състоянието, произхождащ от спецификация за Първи април. Това не е обичаен договор за грешки на приложение, въпреки че някои услуги го използват шеговито.

Практически насоки: Не разчитайте на него за оперативно поведение, съвместимо между различни системи.

Заявката е достигнала сървър, който не може да генерира авторитетен отговор за целевия URI адрес; честа причина е несъответствие между маршрутизирането на връзката и HTTP authority.

Практически насоки: Опитайте отново през подходяща връзка и проверете Host/:authority, SNI и маршрутизирането през прокси.

Типът на съдържанието и синтаксисът са разбираеми, но сървърът не може да приложи инструкциите или да валидира изпратеното съдържание.

Практически насоки: Върнете конкретни подробности за валидирането на отделните полета; коригирането на данните може да позволи успешно изпълнение.

Ресурс на WebDAV е заключен, затова поисканият метод не може да бъде изпълнен, докато условието за заключване не бъде разрешено.

Практически насоки: Проверете кой е заключил ресурса, времето за изчакване и обработката на токена за заключване в WebDAV.

Операция на WebDAV е неуспешна, защото необходима предходна операция в същата последователност от заявки не е успяла.

Практически насоки: Разрешете проблема с предходното неуспешно действие, преди да опитате отново зависимите операции.

Сървърът отказва да обработи заявка, която може да е била повторена по време на ранни данни, за да намали риска от повторно възпроизвеждане.

Практически насоки: Опитайте отново, след като връзката бъде установена без ранни данни.

Сървърът отказва текущия протокол и указва, че клиентът трябва да премине към друг.

Практически насоки: Включете заглавка Upgrade, описваща поддържаните варианти на протокол.

Сървърът изисква условна заявка, за да предотврати загуба на актуализации, но клиентът е изпратил безусловна заявка.

Практически насоки: Извлечете текущото състояние и изпратете подходящо условие, например If-Match.

Клиентът е изпратил твърде много заявки за даден период според ограничение, определено от сървъра.

Практически насоки: Изчакайте преди нов опит, спазвайте Retry-After, когато е зададена, и избягвайте синхронизирани вълни от повторни заявки.

Сървърът няма да обработи заявката, защото едно или повече полета на заглавките или съвкупността от тях са твърде големи.

Практически насоки: Намалете бисквитките/персонализираните заглавки или коригирайте умишлено зададеното ограничение на сървъра.

Сървърът не може да предостави поисканата информация поради правно ограничение.

Практически насоки: Когато е подходящо, обяснете ограничението и неговия обхват, без да разкривате защитена информация.

Сървърът е срещнал неочаквано състояние и не може да завърши заявката. Това е общ резервен код, когато не се прилага по-конкретна грешка на сървъра.

Практически насоки: Съпоставете заявката със сървърните регистрационни файлове и не показвайте подробности за стека на посетителите.

Сървърът не поддържа функционалността, необходима за изпълнение на заявката; често става дума за невнедрен метод или възможност.

Практически насоки: Внедрете функционалността или използвайте поддържан метод; този код не е предназначен за временно претоварване.

Сървър, работещ като шлюз или прокси, е получил невалиден отговор от upstream сървър.

Практически насоки: Проверете състоянието на upstream услугата, настройките на протокола/TLS, DNS и регистрационните файлове на прокси.

Сървърът временно не може да обработи заявката, често поради поддръжка или претоварване.

Практически насоки: Когато е възможно, посочете Retry-After, полезно съобщение и правила за кеширане, подходящи за временна грешка.

Шлюз или прокси не е получил навреме отговор от upstream услуга.

Практически насоки: Проверете забавянето на upstream услугата, мрежовите маршрути и бюджетите за изчакване по цялата верига.

Сървърът не поддържа основната версия на HTTP, използвана в заявката.

Практически насоки: Използвайте поддържана версия на протокола или актуализирайте конфигурацията на сървъра/прокси.

Грешка в конфигурацията на сървъра е създала циклично договаряне на съдържание, при което избраният вариант отново започва договаряне.

Практически насоки: Поправете конфигурацията на вариантите/договарянето; това е проблем от страната на изходния сървър.

WebDAV сървър не може да съхрани представянето, необходимо за завършване на операцията.

Практически насоки: Освободете или осигурете място за съхранение и проверете квотите преди нов опит.

Сървърът е открил безкраен цикъл при обработка на заявка, често при обхождане на WebDAV връзки.

Практически насоки: Прекъснете цикличната връзка между ресурсите или правилото за обработка.

Заявката изисква разширение, което сървърът не поддържа.

Практически насоки: Използвайте поддържан набор от разширения или договорете алтернатива.

Клиентът трябва да се удостовери, за да получи достъп до мрежата, обикновено чрез портал за достъп. Кодът е предназначен за мрежови посредници, а не за вход в уебсайт.

Практически насоки: Завършете удостоверяването за достъп до мрежата и повторете първоначалната заявка.

Някои приложения използват това име, когато сесията за удостоверяване изтече. Това не е универсално присвоен HTTP код на състоянието, затова клиентите не могат да разчитат на еднаква семантика.

Практически насоки: Обновете удостоверяването съгласно условията на услугата.

Специфичен за доставчик отговор, използван исторически за ограничаване на честотата. Значението му се определя от конкретната реализация.

Практически насоки: Следвайте документираните указания за ограничаване на честотата.

Някои сървъри затварят връзката, без да изпратят обичаен отговор, често като мярка за филтриране.

Практически насоки: Проверете регистрационните файлове на доставчика; клиентите може да покажат мрежова грешка вместо този код.

Разширение на Microsoft, използвано от някои услуги, за да поискат от клиента повторен опит с допълнителна информация.

Практически насоки: Следвайте документацията на конкретния API.

Обратен прокси сървър може да запише този код, когато клиентът прекъсне връзката, преди upstream отговорът да е завършен. Обикновено това е класификация в регистрационния файл, а не отговор, изпратен до клиента.

Практически насоки: Проверете прекратените от клиенти заявки и бавните upstream заявки.

Някои хостинг платформи използват този код за квота или ограничение на трафика. Това не е общо HTTP значение, съвместимо между различни системи.

Практически насоки: Проверете квотата на хостинга и настройките за таксуване.

CDN или прокси сървър може да използва този код, когато получи неочакван или празен отговор от изходния сървър.

Практически насоки: Сравнете регистрационните файлове на крайния възел и източника; уверете се, че изходният сървър връща валиден HTTP отговор.

Прокси сървърът не е могъл да установи връзка с източника или източникът я е отказал.

Практически насоки: Проверете наличността на източника, правилата на защитната стена и списъците с разрешени адреси на прокси сървъра.

Крайна услуга се е свързала или е опитала да се свърже с източника, но не е завършила обмена в рамките на времето за изчакване.

Практически насоки: Проверете отзивчивостта на източника и мрежовото забавяне.

Прокси сървърът не е могъл да достигне конфигурирания адрес на източника.

Практически насоки: Проверете DNS разрешаването, маршрутизирането и IP конфигурацията на източника.

Връзката с източника е установена, но източникът не е изпратил HTTP отговор навреме.

Практически насоки: Намалете времето за обработка на източника или коригирайте поддържаните настройки за изчакване.

Прокси сървърът не е могъл да завърши TLS договарянето с източника.

Практически насоки: Проверете сертификатите, съвместимостта на протокола/шифрите и SNI.

Междинна система е отхвърлила сертификата на източника при проверката му.

Практически насоки: Инсталирайте валиден, правилно именуван, надежден и неизтекъл сертификат с пълната верига.

Наследен/специфичен за доставчик код на прокси отчита грешка във връзката за ускоряване към източника.

Практически насоки: Проверете специфичния за доставчика конектор и маршрута до източника.

Някои клиенти или прокси сървъри използват тази стойност за описание на изтичане на времето при четене от мрежата. Тя няма универсално HTTP значение.

Практически насоки: Проверете диагностичната информация на клиента/прокси.

Някои прокси сървъри използват тази стойност, когато опитът за мрежова връзка изтече. Значението зависи от конкретната реализация.

Практически насоки: Проверете достъпността и настройките за изчакване.