Справочник на HTTP статус кодове — безплатно

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

Най-често се използва за надстройка на WebSocket — клиентът запрашва Upgrade: websocket и сървърът отговаря с 101 за преминаване.

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

Позволява на сървърите да изпращат заглавия Link (preload/preconnect), докато окончателния отговор все още се подготвя, така че браузърите да могат да започнат да зареждат критични ресурси по-скоро.

Стандартния отговор за успех. Значението зависи от HTTP метода: GET → ресурс е върнат, POST/PUT → действието е завършено.

Обичайно след POST. Отговорът трябва да включи заглавие Location, насочващо към URL на новия ресурс.

За асинхронни операции — сървърът поставя работата в опашка. Клиентът трябва да попита крайна точка на статуса или да провери по-късно.

Исканието е успешно, но средник (като кеширащ или трансформиращ прокси) е променил полезния товар от оригиналния сървър — например, преком­преси­ране на изображения. Редко в практиката.

Често се използва за операции DELETE или PUT обновления, които не трябва да вращат тяло. Клиентът не трябва да се отдалечава от текущата страница.

Като 204, не се вращ тяло — но клиентът е допълнително казан да нулира формуляра или представлението, което е произвело исканието (напр. изчисти полетата на формуляра за следващия запис).

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

WebDAV: XML тяло докладва резултата на няколко подоперации независимо — напр. групово преместване, където някои елементи успяха, а други не.

WebDAV: използва се вътре в отговорите 207 Multi-Status, за да се избегне повторното посочване на членове на същата колекция, когато привързанията създават цикли.

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

Сървърът предлага множество опции (напр. различни формати или езици) и клиентът трябва да избере една. Редко се използва, защото автоматичното договаряне на съдържание обикновено справя това.

Използвайте за постоянни промени на URL — търсещите машини ще обновят индекса си. Авторитетът на SEO се прехвърля към новия URL.

Показва, че пренасочването не е постоянно. Кеширането е по-малко агресивно, отколкото 301. Използвайте за неща, като 'се изисква вход, пренасочване към /login'.

Използва се след POST подаване — отговорът казва 'вашия POST работи, вижте този GET URL за резултата'. Браузърите винаги ще GET новия URL.

Отговор на условно исканието (с заглавия If-None-Match или If-Modified-Since). Спестява честотната лента — не е върнато тяло.

Ако оригиналното беше POST, пренасочването също използва POST. Съвременна алтернатива на 302, когато сохранението на метода е важно.

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

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

Клиентът трябва да включи идентификационни данни (заглавие Authorization, бисквитка, токен). 'Неавторизирано' е неправилен термин — всъщност означава 'неавтентифицирано'.

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

Различно от 401 — потребителят Е влязъл, но акаунтът му няма разрешение за този ресурс. Проверете логиката на ролите/разрешенията.

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

Например, GET исканието към крайна точка, която приема само POST. Отговорът трябва да включи заглавие Allow, посочващо валидни методи.

Клиентът поискал тип съдържание, език или кодиране (чрез Accept, Accept-Language, Accept-Encoding), които сървърът не може да удовлетвори. Много сървъри пропускат строгото договаряне и вращат подразбирана вместо това.

Като 401, но издадено от прокси: клиентът трябва да изпрати идентификационни данни на Proxy-Authorization. Виждано на корпоративни мрежи с оверификиращи прокси.

Клиентът отнема твърде много време да изпрати тялото на заявката или запазва връзката неактивна. Опитайте заявката отново.

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

По-силна от 404 — сървърът явно знае, че ресурсът Е СЪЩЕСТВУВАЛ преди, но е бил постоянно премахнат. Търсачките ще го премахнат от индекс.

Заявката е отхвърлена, защото липсва заглавие Content-Length и сървърът отказва телата с неизвестен размер. Добавете заглавието и опитайте отново.

Връща се, когато условни заглавия като If-Match или If-Unmodified-Since не успеят — обикновено оптимистична блокировка: някой друг е променил ресурса от вашата версия. Изтеглете отново и опитайте.

Честа при качване на големи файлове. Конфигурацията на сървъра (nginx, apache) задава максимален размер на тялото. Проверете конфигурацията на сървъра.

Обикновено причинено от много дълги низове от запитване (напр. кодиране на данни в GET). Преминете към POST тяло или повишете лимита на сървъра, ако го контролирате.

Например, изпращане на application/xml към сървър, който приема само application/json. Задайте правилно заглавието Content-Type.

Заглавието Range поиска част, която файлът няма — напр. продължаване на изтегляне след края на файла. Отговорът трябва да включва Content-Range с действителния размер.

Изпратено, когато сървърът не поддържа Expect: 100-continue. Някои клиенти изпращат това заглавие по подразбиране при големи POST заявки; отключването обикновено решава проблема.

Априлска шега от 1998 г. (RFC 2324). Някои истински API използват го за шеги или да отбележат остарели крайни точки. Не за производство.

Честа при HTTP/2 повторно използване на връзка: заявката достигна сървър, който не е конфигуриран за целевия хост. Клиентът трябва да опита отново на нова връзка.

Например JSON е разпознат правилно, но липсва задължително поле или стойност на поле е извън диапазон. Честа при отговори на валидиране на REST API.

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

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

Свързано с TLS 1.3 0-RTT (ранни данни): сървърът няма да рискува обработка на възможно повторена заявка. Клиентът трябва да опита отново след като завърши ръкостискането.

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

Сървърът изисква условни заглавия (като If-Match) за предотвратяване на конфликти при загубени актуализации. Изтеглете ресурса, улучете неговия ETag и изпратете отново с If-Match.

Намалете темпото. Отговорът трябва да включва Retry-After заглавие, указващо кога да опитате отново. Честа при API с квоти на заявки.

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

Ресурсът е блокиран по правни причини — цензура, съдебни заповеди или регионални нормативни актове. Номерът е намек към романа Fahrenheit 451.

Родов catch-all за грешки на страната на сървъра. Проверете дневниците на сървъра за действителната причина: необработено изключение, грешка на базата данни и т.н.

Например сървърът не разпознава HTTP метода. Рядко на практика — по-често ще видите 405.

Честа в архитектури на микросервиси. Вашата балансирка на натоварване или обратен прокси получи неправилен отговор от услугата на заден план.

Или е спрян за поддръжка, или е претоварен. Отговорът трябва да включва Retry-After заглавие. Често се връща при развръщане.

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

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

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

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

WebDAV: обработка на Depth: infinity заявка влиза в цикъл (напр. кръгови свързвания). Операцията беше прекратена.

От застарелия HTTP Extension Framework: сървърът се нуждае от повече информация, преди да може да изпълни заявката. Ефективно неупотребяван в съвременния интернет.

Използвано от пленителни портали (хотел/летищни WiFi), за да покажат, че потребителят трябва да се влезе в мрежата, преди да получи достъп до външни сайтове.