HTTP állapotkód-referencia
| Kód | Név | Jelentés |
|---|---|---|
| 100 | Folytatás | A kliensnek folytatnia kell a kérés törzsével |
| 101 | Protokollváltás | Protokollfrissítés elfogadva (pl. WebSocketre) |
| 200 | OK | A kérés sikeres volt — az alapértelmezett sikerválasz |
| 201 | Létrehozva | Új erőforrás jött létre (tipikus POST siker) |
| 202 | Elfogadva | Sorba állítva aszinkron feldolgozásra, még nem kész |
| 204 | Nincs tartalom | Siker szándékosan üres törzzsel |
| 301 | Véglegesen áthelyezve | Az erőforrásnak új állandó URL-je van — frissítse a linkeket; az SEO érték átszáll |
| 302 | Találva | Ideiglenes átirányítás (történelmileg rosszul használva; lásd 303/307) |
| 303 | Másik megtekintése (See Other) | Átirányítás egy GET-re egy másik URL-en (post/redirect/get) |
| 304 | Nem módosult | A gyorsítótárazott másolat még érvényes — ellenőrizze újra ETag/Last-Modified alapján |
| 307 | Ideiglenes átirányítás | Ideiglenes átirányítás a módszer és a törzs megőrzésével |
| 308 | Állandó átirányítás | Állandó átirányítás a módszer és a törzs megőrzésével |
| 400 | Hibás kérés | A szerver nem tudja elemezni/megérteni a kérést |
| 401 | Jogosulatlan | Hitelesítés szükséges vagy sikertelen (a neve ellenére azt jelenti: nem hitelesített) |
| 403 | Tiltott | Hitelesítve vagy sem, a hozzáférés megtagadva |
| 404 | Nem található | Nincs erőforrás ezen az URL-en |
| 405 | Módszer nem megengedett | A HTTP módszer nem támogatott ehhez az erőforráshoz |
| 406 | Nem elfogadható | Egyetlen megjelenítés sem felel meg az Accept fejléceknek |
| 408 | Kérés időtúllépése | A kliens túl sokáig tartott a kérés elküldésével |
| 409 | Ütközés | Állapotütközés, pl. szerkesztési ütközés vagy duplikált létrehozás |
| 410 | Eltűnt | Véglegesen eltávolítva (erősebb, mint a 404 — szándékosan használva) |
| 411 | Szükséges hossz | Content-Length fejléc szükséges |
| 413 | Túl nagy tartalom | A kérés törzse meghaladja a szerver korlátait |
| 414 | URI túl hosszú | Az URL meghaladja a szerver korlátait |
| 415 | Nem támogatott médiatípus | A kérés Content-Type-ja nem támogatott |
| 418 | Teáskanna vagyok | RFC 2324 vicckód, alkalmanként a kávéfőzés elutasítására használják |
| 422 | Feldolgozhatatlan tartalom | A szintaxis rendben van, de a szemantika megbukik a validáción (az API-k imádják ezt) |
| 425 | Túl korai | A szerver nem hajlandó feldolgozni egy esetleg visszajátszott kérést |
| 429 | Túl sok kérés | Sebességkorlát elérve — lassítson, tartsa tiszteletben a Retry-After fejlécet |
| 500 | Belső szerverhiba | Általános szerveroldali hiba |
| 501 | Nincs megvalósítva | A szerver nem támogatja a funkciót |
| 502 | Hibás átjáró | Egy proxy/átjáró érvénytelen választ kapott a felsőbb szinttől |
| 503 | Szolgáltatás nem érhető el | Túlterhelt vagy karbantartás miatt leállt — gyakran átmeneti, Retry-After fejléccel járhat |
| 504 | Átjáró időtúllépés | Egy proxy/átjáró időtúllépésbe futott a felsőbb szintre várva |
| 505 | A HTTP verzió nem támogatott | A kérésben lévő HTTP verzió nem támogatott |
Névjegy
Az állapotkódok a szerver egyszámos összefoglalói minden válaszról, osztályokba csoportosítva: 1xx tájékoztató, 2xx siker, 3xx átirányítás, 4xx a kliens hibázott, 5xx a szerver hibázott. A táblázat azokat a kódokat adja meg, amelyekkel a dolgozó fejlesztők ténylegesen találkoznak, a gyakorlatban számító árnyalatokkal — a 401 a neve ellenére hitelesítetlent jelent, a 403 elutasítás a bejelentkezéstől függetlenül, a 422 az API validációs hiba, a 429 visszalépést követel. A fel nem sorolt kódok (az 1xx hosszú farka és a kísérleti kódok) elég ritkák ahhoz, hogy az osztály önmagában megmondja, hogyan kezelje őket.
Gyakran ismételt kérdések
Mi a különbség a 401 és a 403 között?
401: nem tudjuk, ki Ön (hitelesítsen). 403: tudjuk, és még így sem szabad.
302 vagy 307 egy ideiglenes átirányításhoz?
A 307 megőrzi a metódust és a törzset; a 302 történelmileg lehetővé tette a klienseknek, hogy POST-ról GET-re váltsanak. Új munkához 307-et használjon (vagy 308-at az állandóhoz).