WebGroundwebground.app
Info & vodniki · Spletni razvoj

HTTP statusne kode & odpravljanje napak

Iskalni seznam 1xx–5xx HTTP kod z nasveti za API in CDN.

Prikazano: 26 kod
100

100 Continue

Začetne glave zahtevka so prejete; odjemalec lahko pošlje telo zahtevka.

Nasvet: Pogosto pri večjih prenosih, ki uporabljajo glavo Expect: 100-continue.

101

101 Switching Protocols

Strežnik se je strinjal z nadgradnjo protokola, najpogosteje iz HTTP v WebSocket.

Nasvet: Preverite glavi Upgrade in Connection, če se rokovanje WebSocket zatakne.

200

200 OK

Standardni odgovor, ki potrjuje, da je zahtevek HTTP uspel.

Nasvet: Preverite Content-Type in zgradbo JSON, če odjemalec podatkov še vedno ne prebere.

201

201 Created

Zahtevek je uspel in ustvaril enega ali več novih virov.

Nasvet: Vmesniki REST API običajno vrnejo glavo Location s spletnim naslovom novega vira.

204

204 No Content

Zahtevek je uspel, strežnik pa je namenoma vrnil prazno telo.

Nasvet: Pri odgovorih 204 ne kličite response.json() (pogosto pri DELETE ali CORS OPTIONS).

206

206 Partial Content

Strežnik je posredoval le zahtevani razpon bajtov datoteke.

Nasvet: Uporabljajo ga video predvajalniki in prenos z nadaljevanjem prek glave Range.

301

301 Moved Permanently

Vir se je trajno preselil na nov URL; iskalniki prenesejo vrednost SEO.

Nasvet: Brskalniki 301 agresivno predpomnijo — nova pravila preizkusite zasebno ali s curl -I.

302

302 Found

Vir se začasno streže z drugega naslova; izvirni URL ostane indeksiran.

Nasvet: Pogosto pri prijavnih tokovih OAuth ali začasnem preusmerjanju med vzdrževanjem.

304

304 Not Modified

Shranjena kopija v predpomnilniku še velja glede na glavi ETag ali Last-Modified.

Nasvet: Prihrani pasovno širino za statične datoteke; pri zastarelih preverite Cache-Control.

307

307 Temporary Redirect

Začasna preusmeritev, ki strogo ohrani izvirno metodo HTTP in telo.

Nasvet: Uporabite 307 namesto 302, kadar mora zahtevek POST ostati POST tudi po preusmeritvi.

308

308 Permanent Redirect

Trajna preusmeritev, ki strogo ohrani izvirno metodo HTTP in telo.

Nasvet: Običajna za preusmeritve končnih poševnic v Next.js in prisilni kanonični HTTPS.

400

400 Bad Request

Strežnik zahtevka ni mogel obdelati zaradi napačne skladnje ali parametrov.

Nasvet: Preverite veljavnost JSON, obvezna polja poizvedbe in glavo Content-Type.

401

401 Unauthorized

Preverjanje pristnosti manjka, je poteklo ali je neveljavno za končno točko.

Nasvet: Preverite veljavnost žetona Bearer, predpono ključa API ali piškotke seje.

403

403 Forbidden

Identiteta odjemalca je znana ali blokirana s pravilnikom, a nima dovoljenja.

Nasvet: Preverite vloge RBAC, pravila CORS/WAF ter dovoljenja za datoteke ali shrambo.

404

404 Not Found

Strežnik ne najde zahtevane poti ali vira.

Nasvet: Preverite končne poševnice, osnovno pot, usmerjanje DNS ali izbrisane ID-je.

405

405 Method Not Allowed

Končna točka obstaja, a ne podpira uporabljene metode HTTP (npr. GET namesto POST).

Nasvet: Preverite glavo Allow v odgovoru za seznam dovoljenih metod HTTP.

408

408 Request Timeout

Odjemalec je pošiljal zahtevek predolgo, zato je strežnik zaprl povezavo.

Nasvet: Preverite počasne mobilne prenose ali neskladja časovnih omejitev keep-alive.

409

409 Conflict

Zahtevek je v sporu s trenutnim stanjem ciljnega vira.

Nasvet: Pogosto pri podvojeni registraciji e-pošte ali neujemanju ETag pri optimističnem zaklepanju.

413

413 Content Too Large

Vsebina zahtevka presega omejitev velikosti na strežniku ali posredniku.

Nasvet: Stisnite slike v brskalniku pred nalaganjem ali povišajte omejitve na posredniku.

415

415 Unsupported Media Type

Strežnik zavrača obliko vsebine, navedeno v glavi Content-Type.

Nasvet: Prepričajte se, da Content-Type: application/json ali multipart/form-data ustreza telesu.

422

422 Unprocessable Content

Skladnja je pravilna (npr. veljaven JSON), vendar vrednosti niso prestale preverjanja.

Nasvet: Oglejte si podrobnosti napake za napačno e-pošto, negativne vrednosti ali manjkajoči enum.

429

429 Too Many Requests

Odjemalec je presegel omejitev pogostosti klicev API ali kvoto.

Nasvet: Upoštevajte glavo Retry-After ter dodajte eksponentno zakasnitev z naključnim zamikom.

500

500 Internal Server Error

Na izvornem strežniku je prišlo do nepričakovane neobravnavane izjeme.

Nasvet: Preverite dnevnike strežnika, manjkajoče okoljske spremenljivke ali napake baze.

502

502 Bad Gateway

Posrednik, CDN ali izravnalnik obremenitve je od zalednega strežnika prejel neveljaven odgovor.

Nasvet: Preverite, ali zaledni proces aplikacije deluje in posluša na pričakovanih vratih.

503

503 Service Unavailable

Strežnik je začasno preobremenjen ali izklopljen zaradi načrtovanega vzdrževanja.

Nasvet: Poiščite glavo Retry-After, neuspešne preglede stanja ali omejitve hladnega zagona.

504

504 Gateway Timeout

Posredniku ali CDN-u je potekel čas čakanja na odgovor izvornega strežnika.

Nasvet: Optimizirajte počasne poizvedbe v bazo ali dolga opravila prestavite v čakalne vrste.

Odpravljate napake API? UporabiteJSON oblikovalnik

HTTP statusne kode & odpravljanje napak

Iskalni seznam 1xx–5xx HTTP kod z nasveti za API in CDN.

  • Strežnik je uspešno prejel in obdelal zahtevo HTTP.
  • Napaka odjemalca zaradi neveljavne sintakse, prijave ali omejitve zahtev.
  • Notranja napaka strežnika, nedosegljiv izvor ali potek časa prehoda.

Pogosta vprašanja (FAQ)

Kakšna je razlika med HTTP 401 in 403?+

401 pomeni manjkajočo ali neveljavno prijavo, 403 pa pomeni, da prijavljeni uporabnik nima dovoljenja za dostop.

Kaj pomenita napaki 502 Bad Gateway in 504 Gateway Timeout?+

Obe kažeta na težavo v komunikaciji med proxyjem/CDN in izvornim strežnikom (502 neveljaven odgovor, 504 potek časa).

Raziščite več orodij na WebGround

Prikaži vse