HTTP būsenos kodų žinynas nemokamai

Naudojama užklausoms su Expect: 100-continue. Serveris patvirtina, kad paruoštas gauti turinio dalį prieš klientui jį siunčiant. Retai pasitaiko šiuolaikiniuose žiniatinklio programose.

Dažniausiai naudojama WebSocket atnaujinimams — klientas prašo Upgrade: websocket ir serveris atsako 101, norėdamas perjungti.

WebDAV tarpinis atsakymas, siunčiamas siekiant išvengti kliento skirtojo laiko pasibaigimo vykdant ilgas operacijas. Pasenęs — šiuolaikiniai serveriai jo neturėtų siųsti.

Leidžia serveriams siųsti Link antraštes (iš anksto įkelti/iš anksto prijungti) dar ruošiant galutinį atsakymą, todėl naršyklės gali greičiau pradėti įkelti kritinius išteklius.

Standartinis sėkmės atsakymas. Reikšmė priklauso nuo HTTP metodo: GET → resursas grąžinamas, POST/PUT → veiksmas baigtas.

Dažna po POST. Atsakyme turėtų būti Location antraštė, nurodanti naujo resurso URL.

Asinchroninėms operacijoms — serveris darbą pastatė į eilę. Klientas turėtų apklausti būsenos tašką arba sugrįžti vėliau.

Užklausa sėkminga, bet tarpinis serveris (pvz., talpyklos arba transformuojantis tarpinis serveris) pakeitė pradinio serverio turinį — pavyzdžiui, iš naujo suspaudė vaizdus. Praktiškai retai pasitaiko.

Dažnai naudojama DELETE operacijoms arba PUT atnaujinimams, kurie neturi grąžinti turinio. Klientas neturėtų palikti dabartinio puslapio.

Kaip 204, turinys negrąžinamas — tačiau klientui papildomai nurodoma iš naujo nustatyti formą arba rodinį, kuris sukūrė užklausą (pvz. išvalyti formos laukus kitam įrašui).

Atsakymas į Range užklausą. Naudojamas vaizdo leistuvais ir atsisiuntimo tvarkytuvais, norėdami tęsti nutrauktus atsisiuntimus arba transliuoti didelius failus.

WebDAV: XML turinyje atskirai pateikiamas kelių suboperacijų rezultatas — pvz., grupinis perkėlimas, kai kai kurie elementai perkelti, o kiti ne.

WebDAV: naudojama 207 Multi-Status atsakymuose, norėdami išvengti pakartotinio to paties kolekcijos narių išvardijimo, kai ryšiai sukuria kilpas.

Delta kodavimas: serveris grąžina skirtumą pagal ankstesnę versiją, o ne visą resursą, taip sutaupydamas pralaidumą. Įdiegiama labai retai.

Serveris siūlo kelis pasirinkimus (pvz. skirtingus formatus arba kalbas) ir klientas turėtų pasirinkti vieną. Naudojama retai, nes automatinis turinio derinimas paprastai tai sutvarko.

Naudokite nuolatiniams URL pokyčiams — paieškos varikliai atnaujins savo indeksą. SEO autoritetas perkeliamas į naują URL.

Nurodo, kad peradresavimas nėra nuolatinis. Talpinimas ne toks agresyvus kaip 301. Naudokite tokiais atvejais kaip 'reikalinga prisijungti, peradresavimas į /login'.

Naudojama po POST pateikimų — atsakymas sako 'jūsų POST pavyko, rezultatą žiūrėkite šiame GET URL'. Naršyklės naują URL visada pasiekia GET metodu.

Atsakymas į sąlyginę užklausą (su If-None-Match arba If-Modified-Since antraštėmis). Sutaupo pralaidumą — joks turinys negrąžinamas.

Jei originalas buvo POST, peradresavimas taip pat naudoja POST. Šiuolaikinė 302 alternatyva, kai metodo išsaugojimas svarbus.

Šiuolaikinis 301 pakeitimas, kai norite, kad POST užklausos po peradresavimo liktų POST.

Paplitusios priežastys: blogai suformuotas JSON turinyje, netinkami užklausos parametrai arba trūkstami būtini laukai. Patikrinkite užklausos turinį ir antraštes.

Klientas turi pateikti autentifikavimo duomenis (Authorization antraštę, slapuką, žetoną). 'Unauthorized' yra klaidingas pavadinimas — jis iš tikrųjų reiškia 'neautentifikuotas'.

Iš pradžių skirta skaitmeniniams mokėjimams. Šiuolaikinis naudojimas: API kartais grąžina 402, kai naudotojas viršijo sumokėtą kvotą.

Skiriasi nuo 401 — naudotojas YRA prisijungęs, tačiau jo sąskaita neturi šio resurso prieigos teisių. Patikrinkite vaidmenų/leidimų logiką.

URL yra klaidingas, resursas buvo ištrintas arba jo niekada nebuvo. Serveriai kartais grąžina 404, norėdami paslėpti, kad 403 būtų tikslesnis.

Pavyzdžiui, GET užklausa į tašką, kuris priima tik POST. Atsakyme turėtų būti Allow antraštė, išvardijanti galiojančius metodus.

Klientas paprašė turinio tipo, kalbos arba kodavimo (per Accept, Accept-Language, Accept-Encoding), kurio serveris negali pateikti. Daugelis serverių praleidžia griežtą derinimą ir grąžina numatytąjį variantą.

Kaip 401, tačiau išduodama tarpinio serverio: klientas turi siųsti Proxy-Authorization kredencialus. Matoma korporatyviniuose tinkluose su autentifikavimo tarpiniais serveriais.

Klientas per ilgai siuntė užklausos turinį arba paliko ryšį neaktyvų. Bandykite užklausą dar kartą.

Dažniausiai grąžinama dėl vienalaikio redagavimo konfliktų arba pasikartojančio resurso kūrimo (pvz., vartotojo su jau egzistuojančiu el. pašto adresu sukūrimo).

Stipriau nei 404 — serveris aiškiai žino, kad resursas ANKSČIAU egzistavo, bet buvo visam laikui pašalintas. Paieškos varikliai jį pašalins iš indekso.

Užklausa buvo atmesta, nes trūko Content-Length antraštės, o serveris atsisako priimti nežinomo dydžio turinį. Pridėkite antraštę ir bandykite dar kartą.

Grąžinama, kai sąlyginės antraštės, tokios kaip If-Match arba If-Unmodified-Since, nesiseka — paprastai optimistinis užrakinimas: kas nors kitas pakeitė išteklių nuo jūsų versijos. Iš naujo nuskaitykite ir bandykite dar kartą.

Dažnai pasitaiko keliant didelius failus. Serverio konfigūracija (nginx, apache) nustato didžiausią turinio dydį. Patikrinkite serverio konfigūraciją.

Paprastai sukelia labai ilgos užklausos eilutės (pvz., duomenų kodavimas GET užklausoje). Pereikite prie POST turinio arba padidinkite serverio limitą, jei galite jį valdyti.

Pavyzdžiui, siunčiant application/xml į serverį, kuris priima tik application/json. Tinkamai nustatykite Content-Type antraštę.

Range antraštė prašo failo dalies, kurios nėra — pvz., bandant tęsti atsisiuntimą už failo pabaigos. Atsakyme turi būti Content-Range su tikruoju dydžiu.

Siunčiama, kai serveris nepalaiko Expect: 100-continue. Kai kurie klientai siunčia šią antraštę pagal numatytuosius nustatymus dideliems POST; jos išjungimas paprastai išsprendžia klaidą.

Balandžio 1-osios pokštas iš 1998 m. (RFC 2324). Kai kurie tikri API naudoja jį pokštams arba pasenusiems galiniams taškams žymėti. Nenaudoti produkcinėje aplinkoje.

Dažna naudojant HTTP/2 ryšio pakartotinį naudojimą: užklausa pasiekė serverį, kuris nesukonfigūruotas tam tikslinio serverio vardui. Klientas turėtų bandyti iš naujo naujame ryšyje.

Pavyzdžiui, JSON išanalizuotas teisingai, bet trūko privalomo lauko arba lauko reikšmė buvo už ribų. Dažna REST API patikros atsakymuose.

WebDAV: šaltinio arba paskirties resursą yra užrakinęs kitas klientas, todėl operacijos atlikti negalima. Palaukite, kol užraktas bus atlaisvintas, arba atrakinkite jį naudodami tinkamą žetoną.

WebDAV: priklausomų operacijų grandinėje ankstesnis veiksmas nepavyko, todėl šis neatliktas. Ieškokite ankstesnės klaidos, kad rastumėte pagrindinę priežastį.

Susiję su TLS 1.3 0-RTT (ankstyvaisiais duomenimis): serveris nerizikuos apdoroti galbūt pakartotos užklausos. Klientas turėtų bandyti iš naujo, kai baigsis rankos paspaudimas (handshake).

Serveris atsisako aptarnauti užklausą per dabartinį protokolą, bet aptarnaus po atnaujinimo — atsakyme yra Upgrade antraštė, kurioje nurodomas reikalingas protokolas.

Serveris reikalauja sąlyginių antraščių (pvz. If-Match), kad išvengtų prarasto atnaujinimo konfliktų. Gaukite resursą, užfiksuokite jo ETag ir siųskite iš naujo su If-Match.

Sulėtinkite. Atsakyme turi būti Retry-After antraštė, nurodanti, kada bandyti iš naujo. Dažna API, turinčiuose užklausų kvotas.

Arba viena antraštė, arba bendras antraščių dydis viršija limitą — dažniausiai dėl per didelių slapukų. Išvalykite slapukus arba sumažinkite, ką jūsų programa juose saugo.

Resursas užblokuotas dėl teisinių priežasčių — cenzūra, teismų sprendimai arba regioniniai reglamentai. Skaičius yra nuoroda į romaną „Fahrenheit 451“.

Bendras visų serverio pusės klaidų atvejis. Patikrinkite serverio žurnalus, kad rastumėte tikrąją priežastį: neapdorota išimtis, duomenų bazės klaida ir pan.

Pavyzdžiui, serveris neatpažino HTTP metodo. Praktikoje retai — dažniau pamatysite 405.

Dažna mikropaslaugų architektūrose. Jūsų apkrovos balansuotojas arba atvirkštinis tarpinis serveris gavo netinkamą atsaką iš foninės paslaugos.

Arba vykdoma priežiūra, arba perkrautas. Atsakyme turėtų būti Retry-After antraštė. Dažnai grąžinama diegimo metu.

Fono tarnyba neatsakė laiku. Patikrinkite aukščiau esančios tarnybos sveikatą ir timeout konfigūracijas.

Serveris nepalaiko pagrindinės užklausos HTTP versijos. Su šiuolaikiniais klientais beveik niekada nematoma.

Skaidrus turinio derinimas baigėsi ciklu: pasirinktas variantas pats sukonfigūruotas derinimui. Rodo serverio konfigūracijos klaidą.

Iš pradžių būdingas WebDAV, bet kartais naudojamas ir bendrųjų paskirčių serveriuose. Reiškia, kad serveris negali išsaugoti užklausos dėl saugyklos apribojimų.

WebDAV: apdorojant Depth: infinity užklausą, įvyko ciklas (pvz., apskritos susiejimų grandinės). Operacija nutraukta.

Iš pasenusios HTTP plėtinių sistemos: serveriui reikia daugiau informacijos, kad galėtų įvykdyti užklausą. Šiuolaikiniame žiniatinklyje iš esmės nenaudojama.

Naudojama prieigos portaluose (viešbučių/oro uostų WiFi), kad nurodytų, jog vartotojas turi prisijungti prie tinklo, prieš pasiekdamas išorines svetaines.