HTTP-tilakoodihaku

Etsi HTTP-tilakoodeja ja niiden merkityksiä. Hakusana tai koodi.

Auttoiko tämä laskuri sinua?

Mikä on HTTP-tilakoodihaku?

HTTP-tilakoodit ovat palvelimen palauttama statuskoodi, joka kertoo pyynnön tilan. 2xx = onnistui, 3xx = uudelleenohjaus, 4xx = asiakasvirhe, 5xx = palvelinvirhe.

Milloin käyttää tätä laskuria

  • API-integraation virheenetsintä, jossa pyyntö epäonnistuu ja sinun täytyy ymmärtää mitä tilakoodi oikeasti tarkoittaa
  • Päätös siitä, mitä HTTP-tilakoodia palautetaan omasta API:stasi tietylle virhetilanteelle
  • HTTP-perusteiden opettaminen tai oppiminen web-kehityskurssilla tai -leirillä
  • Virheenkäsittelimen kirjoittaminen, jonka täytyy erottaa eri 4xx- ja 5xx-tapaukset
  • Tutkiminen, miksi uudelleenohjaus ei toimi tarkistamalla palautettiinko 301 vai 302
  • CORS-ongelmien vianmääritys, jossa selain näyttää verkkovirheen, mutta palvelin palautti 200

Vaiheet:

  1. Kirjoita tilakoodi (kuten 404) tai avainsana (kuten "forbidden") hakukenttään.
  2. Suodata kategorian mukaan käyttäen 1xx-5xx-painikkeita, jos haluat selata tiettyä aluetta.
  3. Lue selkeä kuvaus siitä, mitä koodi tarkoittaa ja milloin se yleensä palautetaan.
  4. Käytä tätä pikaoppaana API-vastausten virheenetsinnässä tai virheenkäsittelyä rakentaessasi.

Kaava

200 OK — Pyntö onnistui 301 Moved — Pysyvä uudelleenohjaus 400 Bad Request — Virheellinen pyntö 401 Unauthorized — Tunnistautuminen vaaditaan 403 Forbidden — Pääsy kielletty 404 Not Found — Ei löytynyt 500 Server Error — Palvelinvirhe

Käyttötapaukset

  • Tuntemattoman API-tilakoodin nopea ymmärtäminen
  • Päätös siitä, mitä tilakoodia palautetaan omasta API:stasi tietylle virhetilanteelle
  • Tarkistus siitä, mitä tietty koodi oikeasti tarkoittaa pyynnön epäonnistumisen tutkimisessa
  • HTTP-perusteiden opettaminen tai oppiminen web-kehityskurssilla
  • Tarkkojen virheenkäsittelylogiikojen kirjoittaminen, jotka erottavat eri 4xx- ja 5xx-tapaukset

Keskeiset hyödyt

  • Jokainen yleisesti käytetty tilakoodi yhdessä hakukelpoisessa oppaassa
  • Selkeät englanninkieliset selitykset, ei pelkästään muodollista RFC-kieltä
  • Suodata heti kategorian mukaan (1xx:stä 5xx:een)
  • Ilmainen, nopea, ei rekisteröintiä tarvita

Ammattilaisen vinkit

  • Varaa 5xx-koodit tiukasti palapuolen häviöille — älä käytä niitä ilmoittamaan asiakkaan syöttövirheistä
  • Käytä 429:ttä Retry-After-otsakkeella rajoitettaessa, jotta hyvin toimivat asiakkaat tietävät milloin yrittää uudelleen
  • Suosi 404:ää yleisen virhesivun sijaan, kun resurssi aidosti puuttuu — se on parempi sekä käyttäjille että hakukoneille
  • API-a suunnittellessa valitse spesifit 4xx-koodit (422, 409, 400) sen sijaan, että kaikki ohjattaisiin yleiseen 400:een

Yleisiä vältettäviä virheitä

  • 200 OK palauttaminen pyynnöstä, joka oikeasti epäonnistui, piilottaen virheet seurantatyökaluilta
  • 401 (ei tunnistettu) ja 403 (tunnistettu mutta ei valtuutettu) sekoittaminen
  • 302 käyttäminen uudelleenohjaukseen, jonka pitäisi olla pysyvä (310), mikä vahingoittaa SEO:a
  • Kaikkien 4xx- ja 5xx-virheiden kohteleminen samoin asiakaspuolen virheenkäsittelyssä sen sijaan, että haaroituttaisiin tietyn koodin mukaan

Keskeiset käsitteet selitettynä

Tilarivi: HTTP-vastauksen ensimmäinen rivi, joka sisältää tilakoodin ja lyhyen syy fraasin
Idempotentti: Tiettyjen HTTP-menetelmien ominaisuus, jossa saman pyynnön toistaminen vaikuttaa samalla tavoin kuin yhden tekeminen
Uudelleenohjausketju: Useiden uudelleenohjausten sarja, jonka selain seuraa ennen lopullisen resurssin saavuttamista
Nopeusrajoitus: Rajoittaa kuinka monta pyyntöä asiakas voi tehdä annetussa aikarajassa, usein ilmoitetaan 429:llä

Liittyvät käsitteet

  • JSON-muotoilija:
  • JSON-tarkistaja:
  • Regex-testaaja:
  • URL-kooderi/dekooderi:
  • Base64-kooderi/dekooderi:

Esimerkki

404 Not Found tarkoittaa, että pyydettyä resurssia ei ole olemassaa. Tarkista URL tai yritä myöhemmin uudelleen.

Tulosten tulkinta

Lukujen ensimmäinen numero kertoo kategorian: 2 = onnistui, 3 = uudelleenohjaus, 4 = asiakasvirhe, 5 = palvelinvirhe. Kolme numeroa yhdessä kertovat tarkemman tilan.

Usein kysytyt kysymykset

Mitä eri HTTP-tilakoodien alueet tarkoittavat?
1xx-koodit ovat tiedottavia, 2xx tarkoittaa onnistumista, 3xx osoittaa uudelleenohjausta, 4xx tarkoittaa asiakasvirhettä (kuten puuttuvan sivun pyytämistä) ja 5xx tarkoittaa, että palvelin itse epäonnistui kelvollisen pyynnön täyttämisessä.
Mikä ero on 401 ja 403 välillä?
401 Unauthorized tarkoittaa, ettet ole tunnistanut itseäsi (tai tunnuksesi ovat virheellisiä) — palvelin ei tiedä kuka olet. 403 Forbidden tarkoittaa, että palvelin tietää kuka olet, mutta sinulla ei ole lupaa käyttää resurssia.
Miksi näen joskus 200 sivulle, joka selvästi epäonnistui latautumisessa?
Tämä tarkoittaa yleensä, että palvelin palautti kelvollisen HTTP-vastauksen (siksi 200 OK), mutta vastauksen sovellustason sisältö kuvaa virhettä — yleinen kaava API:ssa, joka sijoittaa virheen yksityiskohdat vastauksen rungon tilakoodin sijaan.
Mikä ero on 301 ja 302 uudelleenohjauksilla?
301 Moved Permanently kertoo selaimille ja hakukoneille päivittää tietonsa ja käyttää uutta URL-osoitetta jatkossa. 302 Found merkitsee tilapäistä uudelleenohjausta — alkuperäistä URL-osoitetta tulisi käyttää tulevissa pyynnöissä.
Mitä 429 Too Many Requests tarkoittaa?
429 osoittaa, että asiakas on lähettänyt liikaa pyyntöjä annetussa aikajaksossa. Palvelin voi sisältää Retry-After-otsakkeen, joka kertoo asiakkaalle milloin yritä uudelleen. Käytä eksponentiaalista taaksepäinperuutusta tämän koodin kohdalla.
Mikä on 503 Service Unavailable?
503 tarkoittaa, että palvelin ei tilapäisesti pysty käsittelemään pyyntöä, yleensä ylikuormituksen tai huollon vuoksi. Toisin kuin 500, tämän odotetaan ratkeavan. Palvelin voi sisältää Retry-After-otsakkeen.
Mitä 418 I'm a Teapot tarkoittaa?
418 määriteltiin aprillipilana RFC 2324:ssä (1998). Se on todellinen tilakoodi, vaikka sitä käytetään harvoin käytännössä. Jotkut palaimet palauttavat sen humoristisena vastauksena virheellisiin pyyntöihin.
Mikä on 404 Not Found?
404 tarkoittaa, että palvelin ei löydä pyydettyä resurssia. Tämä on yleisin asiakasvirhe. Se voi osoittaa rikkinäistä linkkiä, väärin kirjoitettua URL-osoitetta tai resurssia, joka on siirretty tai poistettu.
Mitä CORSilla on tekemistä tilakoodien kanssa?
CORS (Cross-Origin Resource Sharing) -esitarkistuspyynnöt palauttavat 204 No Content onnistuessaan. Jos palvelin ei vastaa oikeilla CORS-otsakkeilla, selain estää vastauksen vaikka tilakoodi olisi 200, mikä näyttää verkkovirheeltä konsolissa.
Kuinka etsin tilakoodia?
Kirjoita numerokoodi (kuten 404) tai avainsana (kuten 'forbidden' tai 'timeout') hakukenttään. Voit myös suodattaa kategorian mukaan käyttäen 1xx–5xx-painikkeita selataksesi tiettyä aluetta.
Mikä on 204 No Content -vastaus?
204 osoittaa, että pyyntö onnistui, mutta palautettavaa sisältöä ei ole. Sitä käytetään yleensä onnistuneen DELETE-pyynnön jälkeen, CORS-esitarkistusvastauksessa tai kun API hyväksyy tiedot palauttamatta runkoa.

Löydä lisää työkaluja

Tuoreita poimintoja koko työkalukirjastostamme.