HTTP būsenos kodai arba atsakymo kodai yra sugrupuoti į penkias kategorijas. 1 × × informacinė, 2 × × sėkmė, 3 × × nukreipimas, 4 × × kliento klaida, 5 × × serverio klaida.
Šiame įraše yra visas HTTP būsenos kodų sąrašas ir trumpas dažniausiai pasitaikančių atsakymo kodų aprašymas.
Kai atliekame API testavimą, paprastai pirmas dalykas, kurį patikriname atsakymą iš API skambučio, yra būsenos kodas. Labai svarbu, kad mes žinotume bent jau dažniausiai pasitaikančius būsenos kodus, kad galėtume greičiau nustatyti problemas.
1xx (informacinė) būsenos kodo klasė nurodo laikiną atsakymą pranešant apie ryšio būseną ar užklausos eigą prieš atliekant prašomą veiksmą ir išsiunčiant galutinį atsakymą.
2xx (sėkmingas) būsenos kodo klasė rodo, kad kliento užklausa buvo sėkmingai gauta, suprasta ir priimta.
200 (Gerai) būsenos kodas rodo, kad užklausa pavyko. 200 atsakymu siunčiama naudingoji apkrova priklauso nuo užklausos metodo.
201 (sukurtas) būsenos kodas rodo, kad užklausa buvo įvykdyta ir dėl to buvo sukurtas vienas ar daugiau naujų išteklių.
204 (be turinio) būsenos kodas rodo, kad serveris sėkmingai įvykdė užklausą ir kad atsakymo naudingosios apkrovos turinyje nėra papildomo turinio, kurį reikia siųsti.
Susijęs:
3xx (peradresavimas) būsenos kodo klasė rodo, kad vartotojo agentas turi atlikti tolesnius veiksmus, kad įvykdytų užklausą.
301 (perkeltas visam laikui) būsenos kodas nurodo, kad tiksliniam ištekliui buvo priskirtas naujas nuolatinis URI, o bet kokiose būsimose nuorodose į šį šaltinį turėtų būti naudojamas vienas iš pridedamų URI.
302 (Rastas) būsenos kodas rodo, kad tikslinis išteklius laikinai gyvena pagal kitą URI.
4xx (kliento klaida) būsenos kodo klasė rodo, kad klientas, atrodo, suklydo.
400 (Blogas užklausa) būsenos kodas rodo, kad serveris negali arba neapdoros užklausos dėl to, kas suvokiama kaip kliento klaida (pvz., Netinkamai suformuota užklausos sintaksė).
401 (Neautorizuotas) būsenos kodas nurodo, kad užklausa nebuvo pritaikyta, nes jai trūksta galiojančių tikslinių išteklių autentifikavimo duomenų.
403 (Uždraustas) būsenos kodas rodo, kad serveris suprato užklausą, bet atsisako ją įgalioti.
404 (nerastas) būsenos kodas rodo, kad kilmės serveris nerado dabartinio tikslinio ištekliaus atvaizdavimo arba nenori atskleisti, kad jis egzistuoja.
405 (metodas neleidžiamas) būsenos kodas nurodo, kad užklausos eilutėje gautą metodą žino kilmės serveris, bet jo nepalaiko tikslinis išteklius.
Būsenos kodas 415 (nepalaikomas laikmenos tipas) rodo, kad kilmės serveris atsisako aptarnauti užklausą, nes naudingoji apkrova yra šio metodo nepalaikomo tikslo ištekliaus formato. Formato problema gali kilti dėl užklausoje nurodyto turinio tipo ar turinio kodavimo arba dėl to, kad tiesiogiai tikrinate duomenis.
„5xx“ (Serverio klaida) būsenos kodo klasė rodo, kad serveris žino, kad padarė klaidą arba negali atlikti prašomo metodo.
500 (vidinė serverio klaida) būsenos kodas rodo, kad serveryje įvyko netikėta sąlyga, dėl kurios jis negalėjo įvykdyti užklausos.
Būsenos kodas 502 (blogas vartai) rodo, kad serveris, veikdamas kaip šliuzas ar tarpinis serveris, gavo neteisingą atsakymą iš gaunamo serverio, prie kurio jis bandė įvykdyti užklausą.
Būsenos kodas 503 (paslauga nepasiekiama) rodo, kad serveris šiuo metu negali patenkinti užklausos dėl laikinos perkrovos ar suplanuotos priežiūros, kuri greičiausiai bus palengvinta po kurio laiko.
Būsenos kodas 504 („Gateway Timeout“) nurodo, kad serveris, veikdamas kaip šliuzas ar tarpinis serveris, negavo laiku atsakymo iš aukštesnio lygio serverio, kurio jam reikėjo pasiekti norint užbaigti užklausą.
Nuoroda: