HTTP kodi stanja
Odgovor HTTP se začne s tristoličnim kodom in kratko frazio razloga. Prva cifra je celoten povzetek: 1xx je začasna, 2xx je uspešna, 3xx kaže drugam, 4xx okrivlja zahtevo, 5xx okrivlja strežnik. Če se spomniš samo tega, lahko prebereš dnevnik, ki ga nikoli pred tem nisi videl.
Fraze razloga tukaj so tiste iz RFC-jev v angleščini, ker je to tisto, kar potuje po žici — strežnik pošlje "Not Found", ne prevoda tega, in fraza, ki jo grephiš v dnevniku, mora ujemati bajte, ki so bili dejansko poslani.
Razlike, ki povzročajo pravo težavo, so znotraj razredov in ne med njimi: 401 proti 403, 301 proti 308 in 502 proti 503 vsaka odgovori drugačno vprašanje o tem, kaj storiti naslednje in je vsaka rutinsko uporabljena za drugo.
1xx — Informativno
3Začasna: odgovor ni končni in slediti bo drugega.
| Koda | Razlog fraza | Kaj to pomeni |
|---|---|---|
| 100 | Continue | Prejete glave, nadaljuj s pošiljanjem telesa. |
| 101 | Switching Protocols | Preklapljanje protokolov — rokovanje WebSocket. |
| 103 | Early Hints | Zgodnje namige: predhod te vire med pripravo pravega odgovora. |
2xx — Uspešnost
5Zahteva je bila prejeta, razumljena in sprejeta.
| Koda | Razlog fraza | Kaj to pomeni |
|---|---|---|
| 200 | OK | Uspešno, s telesom. |
| 201 | Created | Ustvarjeno.Bi moral nositi Location glavo, ki kaže na novi vir. |
| 202 | Accepted | Sprejeto za obdelavo, do katere ni prišlo. |
| 204 | No Content | Uspešno in namerno ni telesa.Pravilen odgovor na DELETE ali prihranek z ničemer za povrnitev. |
| 206 | Partial Content | Delna vsebina — odgovor na zahtevo Range. Nadaljive prenose. |
3xx — Preusmeritev
6Vir je drugje ali je vaša zbirka predpomnilnika še vedno dobra.
| Koda | Razlog fraza | Kaj to pomeni |
|---|---|---|
| 301 | Moved Permanently | Trajno premaknjeno. Posodobi svoje povezave; predpomnilniki ga lahko hranijo za vedno. |
| 302 | Found | Najdeno — časovna preusmeritev.Pogosto izvedeno kot preklapljanje metode na GET, ki 307 popravi. |
| 303 | See Other | Pojdi drugam: pridobi rezultat z GET. Preusmeritev po POST formuli. |
| 304 | Not Modified | Ni spremenjena — vaša zbirka predpomnilnika je aktualna. Poslano brez telesa. |
| 307 | Temporary Redirect | Časovna preusmeritev, metoda in telo ohranjena. |
| 308 | Permanent Redirect | Trajno preusmeritev, metoda in telo ohranjena. |
4xx — Napaka odjemalca
14Zahteva je problematična. Ponovno je bo nespremenjena ne uspela.
| Koda | Razlog fraza | Kaj to pomeni |
|---|---|---|
| 400 | Bad Request | Strežnik sploh ni mogel razčleniti zahteve. |
| 401 | Unauthorized | Ne avtentikovano — strežnik ne ve, kdo si.Poimenovano Unauthorized, vendar to pomeni neautentificirano. Bi moral vključiti WWW-Authenticate. |
| 403 | Forbidden | Avtentificirano in vedno ni dovoljeno. Bolje poverilnice ne bodo pomagale. |
| 404 | Not Found | Nobenega takega vira in strežnik ne bo rekel, ali je tam kdaj obstajal. |
| 405 | Method Not Allowed | Napačna metoda za ta URL.Mora navedati tiste, ki delujejo v glavi Allow. |
| 406 | Not Acceptable | Nič razpoložljivo v obliki, ki jo bo prevzel tvoj Accept glava. |
| 409 | Conflict | Nasprotuje trenutnemu stanju — ureditev glede na zastarelo različico. |
| 410 | Gone | Odšlo: obstajalo je in je bilo namerno odstranjeno. Močnejše kot 404. |
| 413 | Content Too Large | Telo je večje od tistega, kar strežnik sprejema. |
| 415 | Unsupported Media Type | Strežnik ne obravnava te Content-Type. |
| 418 | I'm a teapot | Sem čajnik. Šala iz aprila 1998 je trajno rezervirana. |
| 422 | Unprocessable Content | Pravilno razčlenjeno, vsebina neveljavna — manjkajoče polje, slaba vrednost. |
| 429 | Too Many Requests | Stopnja omejena.Pred ponovnim poskusom poiščite Retry-After in se eksponentno umikajte. |
| 451 | Unavailable For Legal Reasons | Blokiran iz pravnih razlogov. Številka je namenoma Fahrenheit 451. |
5xx — Napaka strežnika
6Zahteva je lahko v redu. To so tiste, ki so vredne ponovnih poskusov.
| Koda | Razlog fraza | Kaj to pomeni |
|---|---|---|
| 500 | Internal Server Error | Neobdelana napaka na strežniku. Nič za popravilo na vaši strani. |
| 501 | Not Implemented | Strežnik sploh ne izvaja te metode. |
| 502 | Bad Gateway | Proxy je dosegel upstream strežnik in nazaj dobil nekaj neuporabljivo. |
| 503 | Service Unavailable | Namerno ne služi — preplavljeni ali v vzdrževanju.Status, ki bi moral nositi Retry-After. |
| 504 | Gateway Timeout | Proxy je obdržal čakanje na upstream strežnik. |
| 505 | HTTP Version Not Supported | Verzija HTTP v zahtevi ni podprta. |
FAQ
Kakšna je razlika med 401 in 403?
401 Unauthorized pomeni, da zahteva ni bila avtentificirana — strežnik ne ve, kdo si, in pravilno 401 vključuje WWW-Authenticate glavo, ki ti pove, kako to dokazati. 403 Forbidden pomeni, da natanko ve, kdo si, pa še vedno ne smeš imeti tega. Ponovno poskušanje 403 s boljšimi poverilnicami za isto identiteto ne bo pomagalo.
Naj uporabim 301 ali 308 za preusmeritev?
308, če metoda važna. Zgodovinsko sta bila 301 in 302 široko izvedena kot "preusmeritvi in prebalov na GET", kar tiho pretvori POST v GET. 307 in 308 sta bila predstavljena, da obljubljata, da se metoda in telo ohranita. Za trajno premik strani, ki je samo kdaj pridobljena, 301 ostaja najboljši razumljiv izbor.
Kaj 422 pomeni, da 400 ne?
400 Bad Request pomeni, da strežnik sploh ne more razumeti zahteve — slabše oblikovan JSON, pokvarjena glava. 422 Unprocessable Content pomeni, da je bil pravilno razčlenjen in vsebina je napačna: pravilno oblikovano telo z manjkajočim obveznim poljem ali datuma v preteklosti. Delitev je koristna prav zato, ker je popravek odjemalca drugačen v vsakem primeru.
Ali je 418 resnična koda stanja?
Resnična je v tem, da je registrirana in vsaka knjižnica HTTP jo pozna, in šala v tem, da prihaja iz aprila 1998 Norcev Hyper Text Coffee Pot Control Protocol. Poskusi, da bi ponovno zahtevali števila za praktično uporabo, so bili zavrnjeni, zato je trajno rezervirana za čajnike.
Zakaj je 503 drugačna od 502?
502 Bad Gateway pomeni, da je proxy dosegel upstream strežnik in nazaj dobil nekaj neuporabljivo. 503 Service Unavailable pomeni, da sam strežnik zdaj namerno ne služi — preplavljeni ali v vzdrževanju — in je tisti, ki bi moral nositi glavo Retry-After, ker je tisti, ki je pričakovati, da se bo okreval.