HTTP-állapotkódok

Ez a szócikk a HTTP (az angol Hypertext Transfer Protocol rövidítése) állapotkódjainak listája. Tartalmazza a szabványos kódokat, valamint néhány nem szabványos, de használatban lévő kódot is.

A HTTP-állapotkódokat a kliens kérésére adott válasz első sora tartalmazza.

Az állapotkódok 3 számjegyből állnak, az első számjegy utal a tartalmukra, ez a számjegy 1-től 5-ig terjedhet. Ez alapján a következő csoportjai vannak az állapotkódoknak:

  • 1xx – tájékoztató információk: A kérést megkapta a szerver, feldolgozás következik
  • 2xx – sikeres kérés: A kérést sikeresen megkapta, elfogadta, megértette a szerver.
  • 3xx – átirányítás: További tevékenységekre van szükség a kérés befejezéséhez.
  • 4xx – klienshiba: A kérés rossz szintaxisú vagy nem teljesíthető.
  • 5xx – szerverhiba: A szervernek nem sikerült egy helyes kérést végrehajtania.

A második és harmadik számjegyre nincsenek szabályok.

Nem minden lehetséges kód létezik, hiába van 404-es kód például, a kódok száma csak 62 (nem szabványosakkal együtt 90).

1-gyel kezdődő kódok

Ezek azt jelzik, hogy a szerver megkapta és értelmezte a kérést. A kérés ideiglenes helyzetét jelzik, a feldolgozás ezek után fog következni. A klienst utasítják, hogy további válaszra várjon. A válasz csak egy állapotsort (állapotkóddal) tartalmaz, valamit opcionálisan fejléceket. Ezek után egy üres sor következik lezárásként. A HTTP/1.0 nem definiál egyetlen 1-gyel kezdődő kódot sem.

  • 100 – folytatás: A kérést elfogadta a szerver, a kliensnek el kell küldenie a kérés törzsét.
  • 101 – protokollváltás: A protokoll megváltoztatását elfogadta a szerver.
  • 102 – feldolgozás (WebDAV): A kérést elfogadta és feldolgozza a szerver, de jelenleg nincs elérhető válasz. Megakadályozza, hogy a böngésző a válaszra várjon.
  • 103 – előzetes információk: A fő HTTP-fejléc előtt elküldött információk jelzésére szolgál.

2-vel kezdődő kódok

Ezek a kódok a sikeres, elfogadott és értelmezett kérést jelzik.

  • 200 – sikeres kérés: A kérést elfogadta a szerver, az eredményt visszaküldi.
  • 201 – létrehozva: Jelzi, hogy a kérés sikeres volt, és az erőforrás létre van hozva, pl egy POST-űrlap eredményeként érkezhet ez a kód.
  • 202 – elfogadva: A kérést elfogadta a szerver, de a feldolgozás nem fejeződött be.
  • 203 (az 1.1 verzió óta) – módosítva: A szerver egy proxy, ami 200-as kódot kapott, és módosított tartalmat küldött vissza.
  • 204 – nincs tartalom: A kérést elfogadta és sikeresen feldolgozta a szerver, de nincs válasz.
  • 205 – tartalom visszaállítása: A szerver felszólítja a klienst, hogy állítsa vissza a dokumentum nézetét, pl. törölje ki az űrlapba beírt adatokat, töröljön le egy canvast stb.
  • 206 – részleges tartalom: A szerver nem küldte el a teljes tartalmat.
  • 207 – több állapot (WebDAV): Ez a kód xml-dokumentumok esetén használatos. Jelzi, hogy a dokumentum több elkülönített részből áll, amelyek mind különböző állapotkóddal rendelkezhetnek.
  • 208 – már jelentve (WebDAV): A DAV részeit korábban már felsorolta a szerver egy korábbi válaszban, így nem közli azokat megint.
  • 226 – IM használata: A szerver teljesített egy GET kérést, az eredmény ennek jelképe. A kérésnek egy A-IM fejlécet kell tartalmaznia.

3-mal kezdődő kódok

Ezek a kódok egy másik tevékenységre utasítják a klienst. Általában átirányításra használják őket.

A kliens user agentje csak akkor hajthatja végre a műveletet, ha a metódus GET vagy HEAD. A kérés automatikus átirányítása megengedett. A user agent dolga a körkörös hivatkozások felismerése és megakadályozása is.

  • 300 – több választás: Jelzi, hogy a kért erőforrásnak több változata is létezik, például egy videó több formátumban is elérhető.
  • 301 – végleges áthelyezés: A kérés véglegesen átirányítva másik URI-re. Nem engedélyezi a metódus váltását.
  • 302 – ideiglenes áthelyezés: A kérés ideiglenesen átirányítva másik URI-re. Nem engedélyezi a metódus váltását.
  • 303 (az 1.1 verzió óta) – máshol megtalálható: A kért erőforrás másik URI-n már megtalálható.
  • 304 – nem változott: Jelzi, hogy az erőforrás nem változott az If-Modified-Since vagy az If-None-Match fejlécben megadott verzió óta, így nem kell újra letölteni azt.
  • 305 (az 1.1 verzió óta) – proxyhasználat szükséges: Jelzi, hogy az erőforrás csak proxyn keresztül elérhető.
  • 306 – proxyváltás: A szerver felszólítja a klienst, hogy váltson proxyt. Ma már nem használt kód.
  • 307 (az 1.1 verzió óta) – ideiglenes átirányítás: A kérés ideiglenesen átirányítva másik URI-re. Engedélyezi a metódus váltását.
  • 308 – végleges átirányítás: A kérés véglegesen átirányítva másik URI-re. Engedélyezi a metódus váltását.

4-gyel kezdődő kódok

Ezek a kódok a kliens által kiváltott hibát jelzik. Egy HEAD kérésre adott válasznak tartalmaznia kell a hiba leírását, illetve annak ideiglenes vagy végleges voltát. Ezek a kódok bármilyen metódusú kérésre használhatóak. A kliensnek minden mellékelt választ meg kell jelenítenie.

  • 400 – hibás kérés: A kérés nem végrehajtható, mert rossz szintaxisú, túl hosszú stb.
  • 401 – nem azonosított: Megegyezik a 403-mal, de meghiúsult azonosítás (a WWW-Autenthicate fejléccel) után jelenik meg.
  • 402 – fizetés szükséges: Jövőbeli használat céljából létrehozva. Eredeti célja az volt, hogy például egy internetes bank részeként működjön. Ez nem valósult meg, a Google egyéb célokra használja.
  • 403 – nincs jogosultság: A kliensnek nincs jogosultsága megtekinteni az oldalt.
  • 404 – nem található: A kért erőforrás nem létezik. Megfelelő ideiglenes és végleges helyzet jelölésére is.
  • 405 – a metódus nem engedélyezett: A használt HTTP-metódus nem engedélyezett, pl egy PUT kérés egy csak olvasható erőforráson.
  • 406 – nem elfogadható: Jelzi, hogy a szerver nem tud választ előállítani az Accept, az Accept-Charset, az Accept-Encoding vagy az Accept-Language fejlécben megadott tulajdonságok miatt.
  • 407 – proxyazonosítás szükséges: A kliensnek azonosítania kell magát a proxyszerveren.
  • 408 – időtúllépés: A szerver túl sokáig várt a kérésre, így a kapcsolat lezárult.
  • 409 – konfliktus: Jelzi, hogy az erőforrás nem elérhető, mert ütközne egy másik folyamattal, pl. egy dokumentum egyidejű szerkesztése.
  • 410 – véglegesen eltűnt: A kért erőforrás nem létezik, és ez így is fog maradni a jövőben is.
  • 411 – probléma a mérettel: A kérés mérete nem megfelelő.
  • 412 – a kliens nem megfelelő: A kliens nem felel meg az egyik feltételnek.
  • 413 – hosszú kérés: A kérés nagyobb a szerver által maximálisan feldolgozhatónál.
  • 414 – hosszú URI: Az URI hosszúsága nagyobb a megengedettnél.
  • 415 – rossz MIME: A kérés MIME-típusát nem támogatja a szerver.
  • 416 – a fájlpozíció nem megfelelő: A kliens egy darabját kérte a fájlnak, de a szerver ezt nem tudja kézbesíteni. Például a kliens egy olyan részét kérte a fájlnak, ami a fájl vége után található.
  • 417 – a szerver nem megfelelő: A szerver nem felel meg azoknak a követelményeknek, amit a kliens az Expect fejlécben meghatározott.
  • 418 – teáskanna vagyok: Ez a kód 1998-ban lett definiálva, áprilisi tréfának szánták. Nem használják.
  • 421 – rossz címzés: A kérést olyan webszervernek küldték, ami nem tud választ előállítani. (Például mert nincs konfigurálva.)
  • 422 – feldolgozhatatlan kérés (WebDAV): A kérés helyesen formázott, de a szerver nem tudja feldolgozni, mert pl. egy XML-dokumentum hibás.
  • 423 – zárolva (WebDAV): A kért erőforrás nem érhető el, mert zárolva van.
  • 424 – problémás függés (WebDAV): A kérés egy másik kéréstől függ, ami meghiúsult.
  • 426 – frissítés szükséges: A szerver felszólítja a klienst, hogy váltson protokollt. (Pl. hogy biztonságos legyen a kapcsolat.)
  • 428 – hiányzó feltételmegadás: A szerver azt jelzi, hogy hiányzik a gyorsítótárazáshoz szükséges fejléc, amivel jelezné a kliens a szervernek a legutóbbi verziószámot.
  • 429 – sok kérés: A kliens túl sok kérést küldött adott időn belül.
  • 431 – túl nagy fejlécek: Valamelyik fejléc, illetve a fejlécek együtt túllépik a megadott méretet.
  • 451 – jogilag letiltva: A jogi okokból letiltott oldalakat jelzi. Ray Bradbury Fahrenheit 451 című novellájára utal.

5-tel kezdődő kódok

Ezek a kódok azt jelzik, hogy a szerver nem tudja végrehajtani a kérést (de az nem hibás). Jelzik, hogy a szerver felkészült olyan hibákra is, amiket nem tud elhárítani. Egy HEAD kérésre adott válasznak tartalmaznia kell a hiba leírását, illetve annak ideiglenes vagy végleges voltát. Ezek a kódok bármilyen metódusú kérésre használhatóak. A kliensnek minden mellékelt választ meg kell jelenítenie.

  • 500 – belső szerverhiba: Egy általános hibaüzenet szerverhibák jelzésére.
  • 501 – nincs megvalósítva: A szerver nem ismerte fel a HTTP-metódust, vagy nem képes teljesíteni a kérést, de a jövőben ez a helyzet meg fog változni. Nagyon gyakran az okozza, hogy a fejlesztő az XMLHttpRequest.open() -ben felcserélte a két paramétert, így a szerver a fájlnevet próbálja HTTP-metódusként értelmezni, a metódust pedig fájlnévként.
  • 502 – rossz gateway: Jelzi, hogy a szerver egy hibás HTTP-választ kapott egy másik szervertől.
  • 503 – a szolgáltatás nem elérhető: A szerver nem képes kezelni a kérést. Általában ez a helyzet csak ideiglenes.
  • 504 – átjáró időtúllépés: Proxyk használják. Jelzi, hogy a szerver nem kapott választ az eredeti szervertől időben.
  • 505 – nem támogatott HTTP-verzió: A szerver nem támogatja a kliens által használt HTTP-verziót.
  • 506 – körkörös hivatkozás: A kiszolgálót rosszul konfigurálták. A kért erőforrás körkörös hivatkozást eredményez.
  • 507 – kevés tárhely (WebDAV): A szerver nem képes a kérést tárolni, mert kevés a tárhely.
  • 508 – végtelen ismétlés (WebDAV): A szerver végtelen ciklusban ismétlődő kéréseket érzékelt a feldolgozáskor.
  • 510 – nincs kiterjesztve: További szolgáltatásokra van szüksége a szervernek, hogy teljesíthesse a kérést.
  • 511 – hálózati azonosítás: A hálózat használata előtt azonosítani kell magunkat, pl. egy Wi-Fi-hálózat használata előtt el kell fogadni a használati feltételeket.

Nem szabványos kódok

Ezek a kódok nem szabványosak, de használják őket, így a böngészők ismerik.

Általánosan használt kódok

Ezek a kódok nem köthetőek valamelyik szoftverhez, illetve több kiszolgáló is használja őket.

  • 103 – ellenőrző pont: Megszakított, de folytatható kérések folytatására szolgál.
  • 218 – rendben van (Apache HTTP Server): Arra szolgál, hogy a válaszok az Apache-n keresztül menjenek, és a 4-gyel vagy 5-tel kezdődő kódok automatikusan lecserélődjenek egy másik, Apache-nak megadott kódra. A ProxyErrorOverride bekapcsolása szükséges hozzá a httpd.conf állományban.
  • 419 – az oldal lejárt (Laravel): A Laravel keretrendszer használja a hiányzó vagy lejárt CSRF-token jelzésére.
  • 420 – sikertelen művelet (Spring keretrendszer): Sikertelen műveletek jelzésére kialakított, ma már nem használt művelet.
  • 420 – sok kérés (Twitter): Jelzi, hogy a kliens túllépte a kérések megengedett számát. Ma a 429-et használják helyette.
  • 450 – szülői felügyelet által blokkolva (Microsoft): A Windows szülői felügyelete által letiltott tartalom.
  • 498 – rossz token (Esri): Az ArcGIS használja. Jelzi, hogy a kliens lejárt vagy hibás tokent küldött.
  • 499 – token szükséges (Esri): Az ArcGIS használja. Jelzi, hogy a kliens nem küldte el a tokent.
  • 509 – maximális sávszélesség túllépve (Apache HTTP Server, CPanel): Jelzi, hogy a kliens túllépte a rendszergazda által meghatározott maximális sávszélességet.
  • 526 – hibás SSL (Cloudflare, Cloud Foundry): Jelzi, hogy az eredeti szerver által küldött SSL-tanúsítvány hibás.
  • 530 – az oldal inaktív (Pantheon): Jelzi, hogy a szerver jelenleg inaktív állapotban van.
  • 598 – időtúllépés: Néhány proxy használja időtúllépés jelzésére.

IIS

Ezeket a kódokat a Microsoft Internet Information Services terméke használja.

  • 440 – lejárt bejelentkezés: A munkamenet lejárt, így a kliensnek újra be kell jelentkeznie.
  • 459 – újrapróbálkozás: A szerver nem tudta értékelni a kérést, mert néhány szükséges információt nem biztosított a kliens.
  • 451 – átirányítás: Az Exchange ActiveSnyc által használt kód. Azt jelzi, hogy a szerver nem elérhető, vagy nem képes elérni a postafiókot.

nginx

Ezeket a kódokat az nginx webkiszolgáló használja.

  • 444 – nincs válasz: Felszólítja a szervert, hogy ne adjon vissza választ, és zárja le a kapcsolatot azonnal.
  • 494 – nagy fejlécek: Jelzi, hogy a kliens túl hosszú kérést/fejlécet küldött.
  • 495 – hiba az SSL-lel: Jelzi, hogy a kliens tanúsítványa hibás.
  • 496 – SSL azonosítás szükséges: A kliensnek azonosítania kell magát SSL-tanúsítvánnyal, de ez nem történt meg.
  • 497 – rossz port: A kliens egy HTTP-kérést küldött egy HTTPS-portra.
  • 499 – lezárt kapcsolat: Jelzi, hogy a kliens lezárta a kapcsolatot azelőtt, hogy a szerver válaszolhatott volna.

Cloudflare

Ezeket a kódokat a Cloudflare fordított proxyja használja.

  • 520 – ismeretlen hiba: Általános hibaüzenet. Kiválthatják a következők:
    • a TCP-kapcsolat korai lezárása (mielőtt válaszolhatna a szerver)
    • a fejlécek túl nagy mérete (meghaladják a 8 kilobájtot)
    • üres válasz az eredeti szervertől
    • hibás HTTP-válasz
    • HTTP-válasz fejlécek nélkül
  • 521 – a szerver lezárta a kapcsolatot: Jelzi, hogy az eredeti szerver lezárta a Cloudflare-ral létesített kapcsolatot.
  • 522 – a kapcsolat lejárt: A Cloudflare nem tudott megegyezni az eredeti szerverrel a TLS-kézfogás során.
  • 523 – az eredeti szerver elérhetetlen: A Cloudflare nem tudott kapcsolódni az eredeti szerverhez.
  • 524 – időtúllépés: A szerver nem küldött választ a Cloudflare-nak, a kapcsolat időtúllépés miatt lezárult.
  • 525 – hiba az SSL/TLS kézfogással: A Cloudflare nem tudta a szerverrel végrehajtani az SSL/TLS kézfogást.
  • 526 – rossz SSL: A Cloudflare nem tudta érvényesíteni az eredeti szerver tanúsítványát.
  • 527 – jelzi, hogy a kérés időtúllépés miatt megszakadt, vagy hibába ütközött a hálózati kapcsolat létrejötte után.
  • 530 – hiba az eredeti DNS-sel: Jelzi, hogy a Cloudflare nem tudta feloldani az eredeti szerver domainnevét.

Fordítás

  • Ez a szócikk részben vagy egészben a List_of_HTTP_status_codes című angol Wikipédia-szócikk fordításán alapul. Az eredeti cikk szerkesztőit annak laptörténete sorolja fel. Ez a jelzés csupán a megfogalmazás eredetét és a szerzői jogokat jelzi, nem szolgál a cikkben szereplő információk forrásmegjelöléseként.

További források