HTTP-olekukoodide viide tasuta

Kasutatakse taotluste puhul, kus Expect: 100-continue. Server kinnitab, et ta on valmis keha vastu võtma enne kliendi saatmist. Modernsetes veebirakendustes harva nähtu.

Kõige sagedamini kasutatakse WebSocket-i täienduste jaoks — klient taotleb Upgrade: websocket ja server reageerib 101-ga protokolli vahetamiseks.

WebDAV vahepealane vastus, et vältida kliendi timeout pikaajaliste toimingute ajal. Aegunud — modernid serverid ei peaks seda saatma.

Võimaldab serveritel saata Link-päised (eelkoormus/eelühendus) lõppvastuse ettevalmistamise ajal, et brauserid saaksid kriitiliste ressursside allalaadimise varem alustada.

Standardne edukas vastus. Tähendus sõltub HTTP-meetodist: GET → ressurss tagastatud, POST/PUT → toiming lõpule viidud.

Tavaline POST järel. Vastus peaks sisaldama Location-päist, mis osutab uue ressursi URL-ile.

Asünkroonsete toimingute jaoks — server pannakse töö järjekorda. Klient peab küsitlust teha või hiljem kontrollima.

Taotlus õnnestus, kuid vahepealane server (nt vahemäluserver või muutev puhverserver) muutis laadungi päritolu serverist — näiteks pildid uuesti tihendades. Praktikas harva.

Sageli kasutatakse DELETE-toimingutele või PUT-värskendustele, mis ei pea keha tagastama. Klient ei tohiks praeguselt lehelt minema navigeerida.

Nagu 204, kehta ei tagastata — kuid kliendile öeldakse ka vormi või vaadet muuta, mis tekitas taotluse (nt tühjendage vormi väljad järgmise kirje jaoks).

Vastus Range-taotlusele. Kasutavad videomängijad ja allalaadimiste haldurid katkestatud allalaadimiste jätkamiseks või suurte failide voogesitamiseks.

WebDAV: XML-kood teatab mitme alamtoiming tulemit eraldi — nt hulgaliigutus, kus mõned üksused õnnestusid ja teised ebaõnnestusid.

WebDAV: kasutatakse 207 Multi-Status vastustes, et vältida koguduse liikmete korduvat loetelu, kui sidemed loovad silmuseid.

Delta kodeerimine: server tagastab erinevuse eelmise versiooni asemel täisressursi asemel, mis säästab ribalaiust. Väga harva rakendatakse.

Server pakub mitut valikut (nt eri vormingud või keeled) ja klient peaks ühe valima. Harva kasutatakse, sest automaatne sisulepingu läbirääkimised tavaliselt seda käsitlevad.

Kasutage jäigale URL-i muutuse jaoks — otsingumootorsüst värskendavad oma indeksit. SEO-i volitus kandub üle uuele URL-ile.

Näitab, et ümbersuunamine pole jäig. Vahemälustamine on vähem aggressiivne kui 301. Kasutage ajutiste asjaolude jaoks, nagu 'sisselogimine nõutav, ümbersuunamata /login-isse'.

Kasutatakse POST-esituste järel — vastus ütleb 'teie POST õnnestus, vaadake selle GET-URL-i tulemuse jaoks'. Brauserid alati GET uusi URL-e.

Vastus tingimuslikule taotlusele (If-None-Match või If-Modified-Since päistega). Säästab ribalaiust — kehta ei tagastata.

Kui originaal oli POST, kasutab ümbersuunamine ka POST-i. Kaasaegne alternatiiv 302-le, kui meetodi säilitamine oluline.

Kaasaegne asendaja 301-le, kui soovite POST-taotlusi jääda POST-ks pärast ümbersuunamist.

Tavalised põhjused: vigane JSON kehas, sobimatud päringuga parameetrid või puuduvad nõutavad väljad. Kontrollige taotluse keha ja päiseid.

Klient peab kaasama autentimisandmed (Authorization-päis, küpsis, märk). 'Unauthorized' on terminoloogiline eksitus — tegelikult tähendab see 'autentimata'.

Algselt mõeldud digitaalsetele maksetele. Kaasaegne kasutus: API-d tagastavad mõnikord 402, kui kasutaja on ületanud oma palgatud piiri.

Erinev 401-st — kasutaja ON sisse logitud, kuid tema konto pole selle ressursi jaoks loaga. Kontrollige rolli/õiguste loogika.

URL on kas vale, ressurss kustutati või seda pole kunagi olnud. Serverid tagastavad mõnikord 404, et varjata, et 403 oleks täpsem.

Näiteks GET-taotlus lõpp-punktile, mis aktsepteerib ainult POST-i. Vastus peaks sisaldama Allow-päist, mis loetleb kehtivad meetodid.

Klient taotles sisuliiki, keelt või kodeeringut (Accept, Accept-Language, Accept-Encoding kaudu), mida server ei suuda rahuldada. Paljud serverid jätavad range läbirääkimised vahele ja tagastavad vaikimisi.

Nagu 401, kuid väljastanud puhverserver: klient peab saatma Proxy-Authorization-andmed. Näha ettevõtte võrkudes, kasutades autentimispuhverserverite.

Klient võttis liiga kaua aega taotluse sisu saatmiseks või jättis ühenduse tühikäigule. Proovige taotlust uuesti.

Tavaliselt tagastatakse samaaegsete muudatuste konfliktide või duplikaat ressursside loomise puhul (nt kasutaja loomine olemasoleva e-postiaadressiga).

Tugevam kui 404 — server teab konkreetselt, et ressurss KUNAGI OLEMAS, kuid see on jäädavalt eemaldatud. Otsingumootorid eemalda indekseeringust.

Taotlus lükati tagasi, kuna seal puudus Content-Length päis ja server keeldub teadmata suurusega kehadest. Lisage päis ja proovige uuesti.

Tagastatakse, kui tingimuslikud päised nagu If-Match või If-Unmodified-Since ebaõnnestuvad — tavaliselt optimistlik lukustamine: keegi muutis ressurssi teie versioonist alates. Tõmmake uuesti ja proovige.

Levinud suurte failide üleslaadimise ajal. Serveri konfiguratsioon (nginx, apache) määrab max keha suuruse. Kontrollige serveri konfiguratsiooni.

Tavaliselt on põhjuseks väga pikad päringustringid (nt andmete kodeerimine GET-is). Vahetage üle POST kehale või tõstke serveri piirangut, kui te seda kontrolliite.

Näiteks application/xml saatmine serverile, mis aktsepteerib ainult application/json. Seadke Content-Type päis õigesti.

Range päis nõuab osa, mida failil pole — nt allalaadimise jätkamine faili lõpu pärast. Vastus peaks sisaldama Content-Range tegelike suurusega.

Saadetakse, kui server ei toeta Expect: 100-continue. Mõned kliendid saadavad seda päist vaikimisi suurte POST-ide puhul; selle keelamine tavaliselt lahendab vea.

1998. aasta aprillinaljak (RFC 2324). Mõned tegelikud API-d kasutavad seda nalijatamiseks või aegunud lõpp-punktide märkimiseks. Mitte tootmises kasutamiseks.

Levinud HTTP/2 ühenduse taaskasutamisega: taotlus jõudis serverile, mis pole sihtmärknimele konfigureeritud. Klient peaks proovima uuel ühendusele.

Näiteks JSON sõeluti õigesti, kuid vajalik väli jäi puudu, või välja väärtus oli vahemikus väljaspool. Levinud REST API valideerimise vastuste puhul.

WebDAV: lähte- või sihtkressurs on lukus teise kliendi poolt, mistõttu operatsiooni ei saa jätkata. Oodake lukustuse eemaldamist või katkestage see õige märgiga.

WebDAV: sõltuvate operatsioonide ahelas ebaõnnestus varasem tegevus, seega seda ei tehtud. Vaadake varasema ebaõnnestumise puhul juurpõhjust.

Seotud TLS 1.3 0-RTT-ga (varased andmed): server ei riski võimalikult kordustatud taotluse töötlemist. Klient peaks pärast käepigistust uuesti proovima.

Server keeldub taotluse teenindamisest praeguse protokolli kaudu, kuid teeb seda pärast uuendamist — vastus sisaldab Upgrade päist, mis nimetab vajaliku protokolli.

Server nõuab tingimuslikke päiseid (nt If-Match) kaotatud värskenduste konfliktide vältimiseks. Tõmmake ressurss, jäädvustage selle ETag ja saatke uuesti If-Match-iga.

Aeglustage. Vastus peaks sisaldama Retry-After päist, mis näitab, millal proovida. Levinud API-de puhul, millel on taotluste kvoodid.

Kas üks päis või kogu päiste suurus ületab piirangu — enamasti on põhjuseks ülisuurte küpsiste. Kustutage küpsised või vähendage, mida teie rakendus neis salvestab.

Ressurss on õiguslikel põhjustel blokeeritud — tsensuur, kohtumäärused või piirkondlikud eeskirjad. Arv viitab romaanile Fahrenheit 451.

Üldine hõive serveripoolsete vigade puhul. Kontrollige serveri logisid tegeliku põhjuse leidmiseks: käsitlemata erind, andmebaasi viga jne.

Näiteks server ei tunda HTTP meetodit. Haruldane praktikas — sagedamini näete 405.

Levinud mikroteenus arhitektuurides. Teie koormuse tasakaalustaja või pöördproksi sai tagumise teenuse vigast vastuse.

Kas hoolduses või ülekoormatud. Vastus peaks sisaldama Retry-After päist. Sageli tagastatakse juurutamiste ajal.

Tagumise teenuse vastamise viivitus. Kontrollige ülesvoolu teenuse tervist ja ajalimiidi konfiguratsioone.

Taotluse peamine HTTP versioon pole serveris toetatud. Peaaegu kunagi ei nähta kaasaegsete klientidega.

Läbipaistev sisu läbirääkimine lõppes silmuses: valitud variant on ise konfigureeritud läbirääkimiseks. Näitab serveri konfiguratsiooni viga.

WebDAV-põhine päritolus, kuid vahel kasutavad üldised serverid. Tähendab, et server ei saa taotlust salvestada salvestusruumi piirangute tõttu.

WebDAV: taotluse töötlemine Depth: infinity sisendit silmuksele (nt ringikujuline seondumine). Operatsioon lõpetati.

Aegunud HTTP Extension Framework'ist: server vajab rohkem teavet, enne kui see võib taotlust täita. Praktiliselt kasutamata kaasaegsel veebil.

Kasutatakse fangitud portaalide poolt (hotelli/lennujaama WiFi) näitamaks, et kasutaja peab enne välistele saitidele juurdepääsuks võrku sisse logima.