Joan eduki nagusira
LibraTool logoLibraTool

HTTP Egoera Kodeen Erreferentzia doan

HTTP egoera-kode guztien erreferentzia bilatu daitekeen — bakoitzaren esanahia, noiz erabiltzen den eta arrazoi arruntak. 100etik 511ra.

Linez kanpo funtzionatzen du behin kargatuta

61 egoera-kode

100

Jarraitu

Zerbitzariak eskaerako entzapenak jaso ditu eta bezeroak gorputzarekin jarraitu beharko luke.

Expect: 100-continue duten eskaera baterako erabiltzen da. Zerbitzariak onartzen du gorputzaren hartzeko prest dagoela bezaileak bidaldu aurretik. Oso gutxi ikusi modernoen web aplikazioetan.

RFC 9110 ↗
101

Protokoloak aldatzen

Zerbitzaria bezaileak eskauta protokoloak aldatzen ari da.

Gehienbat WebSocket eguneratze baterako erabiltzen da — bezeroak Upgrade: websocket eskatzen du eta zerbitzaria 101 ematen du aldatzeko.

RFC 9110 ↗
102

Prozesatzen

Zerbitzariak eskaera jaso du eta prozesatzen ari da, baina ez dago erantzunik oraindik.

WebDAV neurriketa batean bidaltako erantzun itzulkaria bezeroa denboratik atera ez dezan bitartean. Zaharra — zerbitzari modernoek ez lukete bidali beharko.

RFC 2518 ↗
103

Hasierako argibideak

Aurrealdia entzapenak azken erantzunatik lehen bidaltzea.

Zerbitzariek Link entzapenak (aurreurrutiz/prekonektatzea) ondoan bidali ditzakete azken erantzuna oraindik prestatzean, bezeroak baliabide garrantzitsuenak lehenbailehen estra ditzakeen.

RFC 8297 ↗
200

OK

Eskaera arrakastaz osatu zen.

Arrakastaren estandar erantzuna. Esanahia HTTP metodotik dagoena: GET → baliabidea itzuli, POST/PUT → ekintza osatu.

RFC 9110 ↗
201

Sortu

Baliabide berria arrakastaz sortu zen.

Arrunta POST despues. Erantzunak Location entzapena beharko luke baliabide berriaren URLaren zatian seinalatzen.

RFC 9110 ↗
202

Onartua

Eskaera prozesatzen onartua, baina prozesatzea ez dago osaturik.

Asynkrono eragiketa baterako — zerbitzariak lanean dago. Bezeroak egoera amaierako entzapena polling egin edo beranduago itzuli beharko luke.

RFC 9110 ↗
203

Autorizatzekoarena ez informazioa

Erantzuna eraldatzeko proxy batek aldatu zen.

Eskaera arrakastaz, baina bitarte-agenteek (cache edo eraldatzeko proxy bezela) jatorrizkoaren ordaintza aldatu dute — adibidez, irudiak berriz konprimatzea. Oso gutxi praktikan.

RFC 9110 ↗
204

Edukirik ez

Eskaera arrakastaz, baina erantzun gorputzik ez.

Askotan DELETE eragiketarako edo PUT eguneratze baterako, gorputza itzuli beharrik ez duenak. Bezeroak uneko orrian hemendik joan ez beharko.

RFC 9110 ↗
205

Berritze edukia

Eskaera arrakastaz; bezeroak dokumentu ikuspegia berritze beharko luke.

204 bezela, gorputzik ez itzultzen — baina bezeroa gainera esan egiten zaio forma edo ikusi berritze beharko duen eskaera sortzea (adib. hurrengo sarrera baterako eremu hutsak).

RFC 9110 ↗
206

Eduki partzial

Zerbitzariak baliabide baten parte bakarrik bidali zuen.

Range eskaeraren erantzuna. Bideo erreproduzitzailek eta deskargatzeko kudeatzaileek erabiltzen dute etzitako deskargen berrabiatzeko edo fitxategi handiak streama.

RFC 9110 ↗
207

Multi-egoera

Erantzun gorputza zenbait eragiketa baterako egoera kodeak dauka.

WebDAV: XML gorputza zenbait apo-eragiketa baten emaitza adierazten du independenteki — adibidez, zenbait elementuk arrakastaz eta beste batzuk huts egitea duen mugimendu batch.

RFC 4918 ↗
208

Jadanik aditzea

Bilduma baten kideak erantzun honetan lehenago zerrendatu dira.

WebDAV: 207 Multi-egoera erantzunen barruan erabiltzen da bilduma berberaren kideak behin behinean zerrendatzeko gero ez dezan, loturek begiak sortzean.

RFC 5842 ↗
226

IM erabiltzen

Erantzuna baliabidean aplikatutako instantzia manipulazioaren emaitza da.

Desberdintasun kodetzearen: zerbitzariak baliabide osoa beharrean aurreko bertsio baten desberdintasun itzultzen du, bandaren aurra askatzen. Oso gutxi inplementatu.

RFC 3229 ↗
300

Hainbat hautaketa

Baliabide baten zenbait adierazpen erabilgarri daude.

Zerbitzariak hainbat aukera ematen ditu (adib. formatuen edo hizkuntzaren desberdintasun), bezaileak bat aukeratu beharko luke. Oso gutxi erabiltzen, automatiko edukiaren negoziazioak normalean hau kudeatzen duenean.

RFC 9110 ↗
301

Beteeran aldatu

Baliabidea beteeran URL berri batera aldatu zen.

URLaren aldaketa beteak baterako erabili — bilaketa motorren index eguneratu. SEO aginteak URLaren berriarekin zetazkatzen du.

RFC 9110 ↗
302

Aurkitua (Aldi mailako bideratua)

Baliabidea aldi mailakan URL desberdin batean dago.

Bideratua beteeran ez dela adierazten. Cache-atzaila 301 baino gutxiago. Gauzak bezela erabili 'saioa beharrezkoa, /login-era bidertzen'.

RFC 9110 ↗
303

Ikusi beste

GET erabiltzea desberdin URL batera bideratua.

POST bidalketen ondoren erabiltzen da — erantzunak 'zure POST funtzionatu zen, ikusi GET URL hau emaitzarentzat' esaten du. Nabigazaileek beti GET URL berria.

RFC 9110 ↗
304

Aldatugabea

Gordetako bertsioa baliozko oraindik; erabili.

Baldintza eskaeraren erantzuna (If-None-Match edo If-Modified-Since entzapenak). Bandaren aurra aurreztea — gorputzik ez itzultzen.

RFC 9110 ↗
307

Aldi mailako bideratua

302 bezela baina jatorrizko HTTP metodoa kontserbatzen du.

Originalena POST zen, bideratua POST erabiltzen du. Metodoaren kontserbazioa garrantzitsuetan 302-ren modern alternatiboa.

RFC 9110 ↗
308

Beteerako bideratua

301 bezela baina jatorrizko HTTP metodoa kontserbatzen du.

Modern ordezkapena 301-arentzat POST eskaera URL berriaren bidera ondoren POST mantendu nahi denean.

RFC 9110 ↗
400

Eskaera txarra

Zerbitzariak ezin zuen ulertarazi eskaera sintaxe txararen ondorioz.

Arrunta kausa: JSON gorputza txarra, query parametrotan baliogabea edo beharrezko eremuen falta. Begiratu eskaerako gorputza eta entzapenak.

RFC 9110 ↗
401

Autorizatugabea

Autentifikazioa beharrezkoa eta ez ez ez

Bezeroak autentifikazioa datuak sartu beharko luke (Autorizazioa entzapena, cookie, token). 'Autorizatugabea' okerra da — benetan 'autentifikatugabea' esan nahi du.

RFC 9110 ↗
402

Ordaintza beharrezkoa

Etorkizunarako erreser — sarritan APIaren ordainduetarako geruza baterako erabiltzen da.

Hasieran digitalen ordaintzen baterako pentsatua. Modern erabilera: APIak zenbaitano 402 itzultzen dute erabiltzaile batek ordainduaren kontingentzia gainditu badu.

RFC 9110 ↗
403

Debekatua

Bezeroa autentifikatua baina ez du baimena.

401-ren desberdintasun — erabiltzailea logean dago, baina haren kontua ez du baliabide honen baimena. Begiratu rola/baimenak logika.

RFC 9110 ↗
404

Ezagutu ezean

Eskaerako baliabidea ez da zegoen.

Edo URLa okerra, baliabidea ezabatu edo inoiz ez da zegoen. Zerbitzariek zenbaitano 404 itzultzen dute 403 zehatzagoa izango litzateke ezkutatzeko.

RFC 9110 ↗
405

Metodoa ez da onartua

HTTP metodoa erabiltzen ez da baliabide honen baterako onartua.

Adibidez, GET eskaera POST bakarrik onartzen duen amaieraren pean. Erantzunak Allow entzapena beharko luke baliozko metodoak zerrendatzen.

RFC 9110 ↗
406

Ezin onartua

Ez adierazpen batez beterik bezeraren Accept entzapenekin.

Bezeroak eduki mota, hizkuntza edo kodetzearen baterako eskatzen zuen (via Accept, Accept-Language, Accept-Encoding) zerbitzariak ezin asebete. Zenbait zerbitzari estriktu negoziazioa alde banatzen eta defekt bat itzultzen dira.

RFC 9110 ↗
407

Proxy autentifikazioa beharrezkoa

Bezeroak proxya-rekin lehenik autentifikatu behar du.

401 bezela, baina proxy batek argitaratua: bezeroak Proxy-Authorization datua bidali beharko luke. Ikus korporatiboaren sarean proxy autentifikazioenarekin.

RFC 9110 ↗
408

Eskaeraren denbora agurtuta

Zerbitzariak eskaeraren zain itxoin denbora agurtuta.

Bezeroak denbora luzegi hartu du eskaeraren gorputza bidaltzeko edo konexioa inaktibo mantendu du. Saiatu eskaera berriz.

RFC 9110 ↗
409

Gatazka

Eskaera baliabidearen oraingo egoerarekin gatazkan dago.

Normalean edizio bat dopatzeen gatik edo baliabide bikoitzak sortzean bueltatzea (adibidez, dagoeneko dauden emaila duen erabiltzaile bat sortzea).

RFC 9110 ↗
410

Joana

Baliabidea ezabatu eta ez da itzuliko.

404ren baino indartsuagoa — zerbitzariak argiki badaki baliabidea LEHENAGO dagoela baina betiko kendu egin dela. Bilaketa-motoreak desindexatzea egingo du.

RFC 9110 ↗
411

Luzera baina

Zerbitzariak Content-Length goiburuaren beharra du.

Eskaera baztertu egiten da Content-Length goiburua ez duelako eta zerbitzariak ukaturiko gorputza badute. Gehitu goiburuak eta saiatu berriz.

RFC 9110 ↗
412

Baldintza huts egin

Eskaeren goiburuetan baldintza bat ez zen bete.

If-Match edo If-Unmodified-Since bezalako baldintzazko goiburuak huts egiten direnean bueltatzea — normalean optimista giltzatzea: beste inork baliabidea aldatu du zure bertsiotik. Berreskuratu eta saiatu berriz.

RFC 9110 ↗
413

Karga hartu behar da gehiegizko

Eskaeraren gorputza zerbitzariaren tamainaren mugaz gainditzen da.

Arrunta fitxategi handiak igotzean. Zerbitzariaren konfigurazioak (nginx, apache) gehienezko gorputz tamaina ezartzen du. Bilakatu zerbitzariaren konfigurazioa.

RFC 9110 ↗
414

URI gehiegizko luzea

Eskaeraren URLa zerbitzariaren luzeraren mugaz gainditzen da.

Normalean oso eskaeren kateak eragiten du (adibidez, datuak kodifikazioan kodifikatzea). Aldatu POST gorputzera, edo planteatzea zerbitzariaren muga jarri duzun.

RFC 9110 ↗
415

Mediaren mota baimena eman ez duen

Zerbitzariak ez ditu bidalitako Content-Type tratatu ahal.

Adibidez, application/xml bidaltzea zerbitzari batean application/json bakarrik onartzen duena. Ezarri Content-Type goiburuak zuzen.

RFC 9110 ↗
416

Barrutia ez osatuzko

Eskatutako byteak barrutia baliabidearen tamainaren kanpoan dago.

Range goiburuak fitxategi ez duen zatia eskatzen du — adibidez, deskarga bat fitxategiaren amaieraren ondoren berrabiaratzea. Erantzunak Content-Range eta benetako tamaina sartu behar ditu.

RFC 9110 ↗
417

Itxaropena huts egin

Zerbitzariak Expect goiburuaren baldintzak ez ditu bete ahal.

Zerbitzariak Expect: 100-continue ondorioz ez duenean bidaltzea. Zenbait bezero honek hormak bidaltzea lehenespenez; desgaituta egitearen arazoaren arauz ebazten du.

RFC 9110 ↗
418

Tetera naiz

Zerbitzariak kahea egitea dikertzea tetera baita.

1998ean nola aprilean (RFC 2324). Zenbait API benetakoak erabili dute txistea aditzean edo zaharkitutako amaierara markatzera. Ez da produkziorako erabil.

RFC 2324 ↗
421

Bidenabarratzen eskaera

Eskaera ez duen erantzun ahal zerbitzari baten bidaltzea.

Arrunta HTTP/2 konexioaren berrerabileaz: eskaera atarira iritsi da ez dago konfiguraturiko zerbitzaria. Bezeroak saiatu behar du konexio berri batean.

RFC 9110 ↗
422

Edukia ez osatu dezakete

Eskaera sintatikoki baliotsua baina semantikoki okerra.

Adibidez, JSON zuzen parseatu baina eremu beharrezkoaren faltzaz, edo eremuaren balioak ez dute adiera duten. Arrunta REST API validazio erantzunetan.

RFC 9110 ↗
423

Blokeaturik

Baliabidea blokeatua dago.

WebDAV: iturburuaren edo helmuaren baliabidea beste bezero batek blokeatua da, beraz eragiketaz ezin du aurrera egin. Itxoin blokeoaren askapenari edo ezabarrean tokiaren botereagatik.

RFC 4918 ↗
424

Mendekoa huts egin

Eskaera huts egin da aurreko eskaera araberakoaren akasten zenbatzen.

WebDAV: eguneratzea araberakoadenetan, aurreko ekintza-a huts egin eta ez zen egin. Ikusi aurrekoa akatsa-gaia-a.

RFC 4918 ↗
425

Goizean egiten

Zerbitzariak oihartzun ahal duen eskaera prozesatzen ez du onartu.

TLS 1.3 0-RTT (hasierako datuak) dituzte: zerbitzariak ez du onartu eskaintzak oihartzun ahal. Bezeroak berriz saiatu behar du eskuarki bukatutzen ondoren.

RFC 8470 ↗
426

Aitzindari bila

Bezeroak protokolo ezberdina aldatu behar du.

Zerbitzariak eskaera ez du onarritzen oraingo protokoloan baina ondoren urrunago — erantzunak Upgrade goiburuak eta beharrean protokoloak dituzte.

RFC 9110 ↗
428

Baldintza beharrezkoa

Zerbitzariak baldintza egoera behar du eskaera bihurtu behar.

Zerbitzariak baldintzazko goiburuak behar (If-Match bezala) galeraren-eguneraketa gatazken saihestea. Berreskuratu baliabidea, hartu bere ETag, eta berriz bidali If-Matcharekin.

RFC 6585 ↗
429

Gehiegizko eskaera

Bezeroak tasa-mugaturik dago.

Motelagoa. Erantzunak Retry-After goiburuak sartu behar du zeintaz saiatu berriz. Arrunta API boterekoak eskaera kuotarekin.

RFC 6585 ↗
431

Eskaeraren goiburuaren eremu gehiegizko handia

Goiburuak zerbitzariak prozesatua ez diren handiak.

Goiburua edo goiburuaren tamaina osoa mugaez gainditzen du — sarrienan gehiegizko cookie-rekin eragiten. Garbitu cookie-ak edo laburtzen dituzu zer gordetzen duzun.

RFC 6585 ↗
451

Lege-arrazoia duten legez gainean ez

Sarrera ukatua lege baldintza direna.

Baliabidea blokeatua dago lege-arrazoia direla — zentsura, gela-agindua edo eskualdeko araudia. Zenbakia nobelaren 451 Fahrenheit aipagarria.

RFC 7725 ↗
500

Barne zerbitzariaren akasten

Zerbitzariak espero ez den baldintza topatu.

Zerbitzari-aldean akasten orokorreko. Ikusi zerbitzariaren sartua benetako kausa: utzita uzten den salbuespena, databasearen akasten, eta bestagaz.

RFC 9110 ↗
501

Ezarritua ez duten

Zerbitzariak ez du onartzen eskatutako gaiak.

Adibidez, zerbitzariak ez du HTTP metodoa ezagutzen. Arraroa praktikatean — gehiago ikusiko duzu 405.

RFC 9110 ↗
502

Aska atea akasten

Zerbitzariak (atean entzuten), ez zeukan erantzun galea atzeko zerbitzari batean.

Arrunta mikroeta-arkitekturetan. Zure carga-oreketa edo atzeko proxya ez zeukan erantzuna atzeko-zerbitzari batean.

RFC 9110 ↗
503

Zerbitzua ezinezkoa

Zerbitzariak ez du ahaltzea eskaera betea duen unean.

Mantenua edo gainezka direna. Erantzunak Retry-After goiburuak sartu behar du. Argiak itzultzen duten barrutiko unplegutzetan.

RFC 9110 ↗
504

Atean denbora agurtuta

Ateak zerbitzariak atzeko erantzunen zain denbora agurtuta.

Atzeko zerbitzariak ez zeukan erantzun astietan. Bilakatu atzeko zerbitzariaren osasun eta denbora-konfigurazioa.

RFC 9110 ↗
505

HTTP bertsioa ez onartzen

Zerbitzariak ez du onartzen eskaeratan erabilitako HTTP bertsioa.

Eskaeraren HTTP bertsioa handiak ez dira onartzen zerbitzariak. Ia ez dute ikusten bezero modernoetan.

RFC 9110 ↗
506

Aldaketa negoziatu

Zerbitzariak eduki negoziazio gaizko konfigurazioa du.

Zehartzea eduki negoziazioa begira begizta: aukeratutako aldaketa da bere konfiguraturik negoziatzera. Adierazten du zerbitzariaren konfigurazioan akasten.

RFC 2295 ↗
507

Soberan biltegi

Zerbitzariak disko-agotzea du.

WebDAV-zehatzak jatorrian baina zenbait zerbitzariek orokorra erabiltzen duten. Zerbitzariak ez ditu ahaltzea eskaera gordetzen dituen biltegiaren mugagatik.

RFC 4918 ↗
508

Begira eskatuta

Zerbitzariak begira infinitua zientifikatu zehatza eskaera prozesatuz.

WebDAV: Depth: infinity eskaera prozesatuz begira begizta sartu (adibidez, zirkular loturak). Eragiketaa etea egin zen.

RFC 5842 ↗
510

Ez zabala

Eskaera zabalgoia gehiago behar dituzte.

Zahartzea HTTP zabalgoia ingurumarian: zerbitzariak behar du informazioaren gehiago aurrera egin baino. Egina ez deitzen gaurko webetan.

RFC 2774 ↗
511

Sarearen autentifikazioa beharrezkoa

Bezeroak sareko sarrera (sare-sarerea lortza autentifikatu behar du.

Captiboa ataria (hotela/aireportuara WiFi) markatzera sarrera-behar sarrera-emaitza aurrera gaineratugaitik.

RFC 6585 ↗

Ohiko erabilerak

  • Erreferentzia API DiseinatzerakoREST APIs diseinatzean, aukeratu zuzena estatusa kodea erantzun bakoitzaren.
  • Bilatu Akats Kodeak AzkarraZure aplikazioa HTML akats dezutsentzen hala, bilatu zer benetan sinatzen.
  • Ikastea HTTP Status KodeakOsatuak erreferentzia ikaslea eta garatzailea ikasten HTTP eta REST.
  • Azkarra Erreferentzia Gertakariak GaraianProdukzio gertakari garaian, azkarra bilatu zer bakoitzak statusa kodea sinatzen.
  • API Dokumentaziorako ErreferentziaAPI dokumentazioa idazten duzunean, itzuli ditzaketen estatua kodeen deskripzio autentikoetara.

Nola Funtzionatzen Du

Tresna hau 63 HTTP egoera-kodeen kode gogorreko bilaketa-taula baten inguruan eraikitako bezero-aldeko erreferentzia bat da, bost klase guztiak hartzen dituena (1xx–5xx), bakoitza definitzen duen RFC zenbakiarekin idatzita. Ez dago zerbitzari-deirik, kanpo APIrik, edo sareko eskaerarik — iragazpen eta bistaratze guztia nabigatzailean gertatzen da JavaScriptek barneko array eta kate metodoak erabiliz.

  1. 1
    Bilaketa-taula kargatuta
    IANAk erregistratutako 63 egoera-kodeen multzo osoa zuzenean txertatuta dago tresna honetan JavaScript array gisa, sarrera bakoitzak kode zenbakizkoa, izen kanoniko ingelesa, kategoria-klasea, eta hori definitzen duen RFC zehatza daramatza (adib. RFC 9110 HTTP/1.1 kode gehienetarako, RFC 6585 429 Eskaera Gehiegirako, RFC 2324 418 Ni Teontzi Bat Naiz-erako).
  2. 2
    Iragazkia memorian exekutatzen da
    Idatzi edo kategoria-iragazki bat aukeratzen duzun heinean, JavaScripten Array.filter-ek memoria barneko zerrendaren gainean funtzionatzen du, zure kontsulta egoera-kode zenbakiarekin, izen kanonikoarekin, eta bai deskribapen labur bai luzeko kateekin parekatuz String.includes erabiliz — debounce atzerapenik ez, zerbitzari-joan-etorririk ez.
  3. 3
    Xehetasunak RFC estekarekin hedatzen dira
    Emaitza bakoitza HTML details/summary elementu gisa errendatzen da. Sarrera bat hedatzeak azalpen luzea eta rfc-editor.org-eko RFC autoritarioaren esteka zuzen bat agerian jartzen ditu, beraz edozein koderen zehaztapen-testu zehatza irakur dezakezu.
  4. 4
    Esteka sakonak eta arbel-kopia
    Sarrera bat irekitzeak URL hash-a kode-zenbakira eguneratzen du (adib. #404), orria partekagarri eta markadore-lagunkoi bihurtuz. Kopiatu botoiak kate kanonikoa (adib. '404 Not Found') arbelera idazten du nabigatzailearen navigator.clipboard APIaren bidez.

Erlazionatutako tresnak

Maiz egiten diren galderak