Даведнік кодаў стану 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, cookie, токен). «Unauthorized» — няслушная назва: насамрэч гэта значыць «неаўтэнтыфікаваны».

Арыгінальна атрымана для лічных плацяжоў. Сучасны выкарыстанне: 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 (раннія даныя): сервер не будзе рызыкаваць апрацоўваць магчыма паўторны запыт. Кліент павінен паўтарыць спробу пасля завяршэння handshake.

Сервер адмаўляецца адпраўляць запыт над поточным пратаколам, але адпраўляе пасля абнаўлення — адказ ўтрымлівае заголовак Upgrade, імя патрэбнага пратакола.

Сервер патрабуе ўмовныя заголовкі (як If-Match) каб прадухіліць конфліктаў потраты. Завяраце ресурс, прахіпайце яго ETag і адпраўце яго з If-Match.

Сповольніцеся. Адказ павінен ўтрымліваць заголовак Retry-After, які паказвае, калі спробаваць яшчэ раз. Распаўсюджана з API, якія маюць квоты запытаў.

Або адзін загаловак, або агульны памер загалоўкаў перавышае ліміт — часцей за ўсё з-за завялікіх cookie. Ачысціце cookie ці змяншыце тое, што ваша праграма ў іх захоўвае.

Ресурс заблакаваны па юрыдычных прычынах — цэнзура, судовыя ордэры ці рэгіённальныя рэгуляцыі. Лічба спасылаецца на раман Fahrenheit 451.

Агульны адхід для памылак на боку сервера. Праверьце журналы сервера для фактычнай прычыны: необработаны выніму, памылка базы дадзеных і т.д.

Напрыклад, сервер не распазнае HTTP метад. Рэдка на практыцы — часцей вы бачыце 405.

Распаўсюджана ў архітэктурах мікрасэрвісаў. Ваш балансыровач нагрузкі ці зваротны проксі атрымаў неправільны адказ ад задняга сэрвіса.

Ці адключаны для тэхнічнага абслужывання, ці перагружаны. Адказ павінен ўтрымліваць заголовак Retry-After. Часта вяртаецца падчас развёртванняў.

Задні сэрвіс не адказаў дастаткова хутка. Праверьце стан вышэйшага сэрвіса і канфігурацыю тайм-аўтаў.

Асноўная версія HTTP запыту не падтрымліваецца серверам. Практычна не сустракаецца з сучаснымі кліентамі.

Празрыстае ўзгадненне змесціва завяршылася цыклам: выбраны варыянт сам настроены на ўзгадненне. Паказвае на памылку канфігурацыі сервера.

WebDAV-спецыфічны па паходжанню, але часам выкарыстоўваны агульнымі сервераамі. Означае, што сервер не можа захаваць запыт з-за абмежаванняў сховы.

WebDAV: апрацоўка запыту Depth: infinity ўвайшла ў цыкл (напр. цыклічныя прывязкі). Аперацыя была спынена.

З пройлугаўшага HTTP Extension Framework: сервер патрабуе больш інфармацыі да таго, як ён можа спалніць запыт. Фактычна не выкарыстоўваецца ў сучаснай сеціве.

Выкарыстоўваецца пленнымі порталамі (гасцінічны/аэрапорт WiFi) каб паказаць, што карыстальнік павінен ўвайсцуўца ў сеціва да доступу ва вонкавыя сайты.