WebGroundwebground.app
Tieto & oppaat · Web-kehitys

HTTP-tilakoodit & vianetsintä

Haettava luettelo 1xx–5xx HTTP-tilakoodeista ja API-vinkeistä.

Näytetään 26 koodia
100

100 Continue

Pyynnön alkuotsikot on vastaanotettu; asiakas voi jatkaa lähettämällä rungon.

Vinkki: Yleinen suurissa latauksissa, kun käytetään Expect: 100-continue -otsikkoa.

101

101 Switching Protocols

Palvelin hyväksyi protokollan päivityksen, yleensä HTTP:stä WebSocketiin.

Vinkki: Tarkista Upgrade- ja Connection-otsikot, jos WebSocket-kättely jää kesken.

200

200 OK

Vakiovastaus onnistuneesti käsiteltyyn HTTP-pyyntöön.

Vinkki: Tarkista Content-Type ja JSON-rakenne, jos sovellus silti epäonnistuu jäsentämisessä.

201

201 Created

Pyyntö onnistui ja loi vähintään yhden uuden resurssin.

Vinkki: REST-rajapinnat liittävät mukaan Location-otsikon uuden resurssin osoitteella.

204

204 No Content

Pyyntö onnistui, ja palvelin palautti tarkoituksella tyhjän rungon.

Vinkki: Älä kutsu response.json() 204-vastauksella (yleinen DELETE- ja OPTIONS-pyynnöissä).

206

206 Partial Content

Palvelin toimitti vain pyydetyn tavualueen tiedostosta.

Vinkki: Käytetään suoratoistossa ja jatkettavissa latauksissa Range-otsikoilla.

301

301 Moved Permanently

Resurssi on siirretty pysyvästi uuteen URL-osoitteeseen; hakukoneet siirtävät arvon.

Vinkki: Selaimet välimuistittavat 301-ohjauksia pitkään — testaa incognitossa tai curl -I:llä.

302

302 Found

Resurssi löytyy tilapäisesti toisesta osoitteesta; alkuperäinen URL säilyy indeksissä.

Vinkki: Käytetään usein OAuth-kirjautumisessa tai tilapäisissä huolto-ohjauksissa.

304

304 Not Modified

Välimuistissa oleva kopio on yhä voimassa ETag- tai Last-Modified-otsikon perusteella.

Vinkki: Säästää kaistaa staattisilla resursseilla; tarkista Cache-Control vanhentuessa.

307

307 Temporary Redirect

Tilapäinen uudelleenohjaus, joka säilyttää HTTP-metodin ja rungon ennallaan.

Vinkki: Käytä 307:ää 302:n sijaan, kun POST-pyynnön täytyy pysyä POSTina ohjauksen jälkeen.

308

308 Permanent Redirect

Pysyvä uudelleenohjaus, joka säilyttää HTTP-metodin ja rungon muuttumattomina.

Vinkki: Yleinen Next.js:n loppukauttaviivaohjauksissa ja HTTPS-pakotuksessa.

400

400 Bad Request

Palvelin ei voinut käsitellä pyyntöä virheellisen syntaksin tai parametrien vuoksi.

Vinkki: Tarkista JSON-muotoilu, pakolliset kyselykentät ja Content-Type-otsikko.

401

401 Unauthorized

Todennus puuttuu, on vanhentunut tai virheellinen pyydetylle reitille.

Vinkki: Tarkista Bearer-tunnisteen voimassaolo, API-avaimen etuliite tai istuntoevästeet.

403

403 Forbidden

Käyttäjä tunnistettu tai estetty säännöillä, mutta käyttöoikeus puuttuu.

Vinkki: Tarkista RBAC-roolit, CORS-/WAF-säännöt sekä tiedosto- ja bucket-oikeudet.

404

404 Not Found

Palvelin ei löydä pyydettyä reittiä tai resurssia.

Vinkki: Tarkista loppukauttaviiva, base-polku, DNS-reititys tai poistetut tunnisteet.

405

405 Method Not Allowed

Reitti on olemassa, mutta ei tue käytettyä HTTP-metodia (esim. GET vs. POST).

Vinkki: Katso Allow-vastausotsikosta palvelimen tukemat HTTP-metodit.

408

408 Request Timeout

Asiakas lähetti pyyntöä liian kauan ennen kuin palvelin sulki yhteyden.

Vinkki: Tarkista hitaat mobiililataukset tai keep-alive-aikakatkaisujen ristiriidat.

409

409 Conflict

Pyyntö on ristiriidassa kohderesurssin nykyisen tilan kanssa.

Vinkki: Yleinen päällekkäisessä rekisteröinnissä tai vanhentuneella ETagilla muokattaessa.

413

413 Content Too Large

Pyynnön kuorma ylittää palvelimen tai välityspalvelimen kokorajan.

Vinkki: Pakkaa kuvat selaimessa ennen latausta tai kasvata välityspalvelimen kokorajaa.

415

415 Unsupported Media Type

Palvelin hylkää Content-Type-otsikossa määritellyn runkomuodon.

Vinkki: Varmista, että Content-Type: application/json tai multipart/form-data vastaa dataa.

422

422 Unprocessable Content

Syntaksi on kelvollinen (esim. validi JSON), mutta kenttien arvot hylättiin.

Vinkki: Tarkista virheestä virheellinen sähköposti, negatiivinen luku tai puuttuva enum-arvo.

429

429 Too Many Requests

Asiakas ylitti API:n pyyntörajoituksen tai purske-kiintiön.

Vinkki: Noudata Retry-After-otsikkoa ja käytä eksponentiaalista viivettä jitterillä.

500

500 Internal Server Error

Lähdepalvelimella tapahtui odottamaton käsittelemätön poikkeus.

Vinkki: Tarkista palvelimen lokit, puuttuvat ympäristömuuttujat ja tietokantavirheet.

502

502 Bad Gateway

Välityspalvelin, CDN tai kuormantasain sai virheellisen vastauksen yläjuoksulta.

Vinkki: Varmista, että taustapalvelu on käynnissä ja kuuntelee odotettua porttia.

503

503 Service Unavailable

Palvelin on tilapäisesti ylikuormittunut tai huoltokatkossa.

Vinkki: Tarkista Retry-After-otsikot, epäonnistuneet health-checkit tai cold-startit.

504

504 Gateway Timeout

Välityspalvelin tai CDN aikakatkaisi odottaessaan yläjuoksun palvelinta.

Vinkki: Optimoi hitaat tietokantakyselyt tai siirrä raskaat ajot taustajonoon.

Tutkitko API-vastauksia? KäytäJSON-muotoilijaa

HTTP-tilakoodit & vianetsintä

Haettava luettelo 1xx–5xx HTTP-tilakoodeista ja API-vinkeistä.

  • Palvelin vastaanotti ja käsitteli HTTP-pyynnön onnistuneesti.
  • Asiakasvirhe virheellisen syntaksin, puuttuvan kirjautumisen tai rajoituksen vuoksi.
  • Palvelinvirhe taustajärjestelmässä tai yhdyskäytävän aikakatkaisu.

Usein kysytyt kysymykset (FAQ)

Mikä ero on HTTP 401- ja 403-koodeilla?+

401 tarkoittaa puuttuvaa tai virheellistä kirjautumista, kun taas 403 tarkoittaa, että tunnistetulla käyttäjällä ei ole käyttöoikeutta.

Mitä tarkoittavat 502 Bad Gateway ja 504 Gateway Timeout?+

Molemmat kertovat yhteysongelmasta välityspalvelimen/CDN:n ja taustapalvelimen välillä (502 virheellinen vastaus, 504 aikakatkaisu).

Tutustu muihin WebGround-työkaluihin

Näytä kaikki