Pāriet uz galveno saturu

HTTP statusa kodu atsauce bez maksas

Meklējama atsauce visiem HTTP statusa kodiem — ko katrs nozīmē, kad tas tiek izmantots un izplatīti iemesli. No 100 līdz 511.

Darbojas bezsaistē pēc ielādes

61 statusa kods

100

Turpināt

Serveris ir saņēmis pieprasījuma galvenes un klients var turpināt ar ķermeni.

Tiek izmantots pieprasījumiem ar Expect: 100-continue. Serveris apstiprina, ka tas ir gatavs saņemt ķermeni, pirms klients to nosūta. Modernajos tīmekļa lietojumprogrammas to reti redz.

RFC 9110 ↗
101

Protokola maiņa

Serveris pārslēdzas uz protokolu, ko pieprasīja klients.

Visbiežāk izmantots WebSocket uzlabojumiem — klients pieprasa Upgrade: websocket un serveris atbild ar 101, lai pārslēgtos.

RFC 9110 ↗
102

Apstrāde

Serveris ir saņēmis pieprasījumu un to apstrādā, bet pagaidām nav pieejama atbilde.

WebDAV starpposma atbilde, kas nosūtīta, lai novērstu klienta noilgošanos ilgu darbību laikā. Novecojis — modernajiem serveriem to nevajadzētu sūtīt.

RFC 2518 ↗
103

Agrīnie mājienu

Prelimināras galvenes, kas nosūtītas pirms galīgās atbildes.

Ļauj serveriem sūtīt Link galvenes (preload/preconnect), kamēr galīgā atbilde joprojām tiek sagatavota, lai pārlūki varētu sākt ātrāk ielādēt kritiskus resursus.

RFC 8297 ↗
200

Labi

Pieprasījums izdevās.

Standarta panākuma atbilde. Nozīme ir atkarīga no HTTP metodes: GET → resurss atgriezts, POST/PUT → darbība pabeigta.

RFC 9110 ↗
201

Izveidots

Jauns resurss tika veiksmīgi izveidots.

Parastais rezultāts pēc POST. Atbildē jāiekļauj Location galvene, kas norāda uz jaunā resursa URL.

RFC 9110 ↗
202

Pieņemts

Pieprasījums tika pieņemts apstrādei, bet apstrāde nav pabeigta.

Asinhroniem darbībām — serveris ir iestādinājis darbu rindā. Klients var aptaujāt statusa galapunktu vai vēlāk pārbaudīt.

RFC 9110 ↗
203

Neoficiāla informācija

Atbilde tika modificēta ar transformējošu starpniekserveri.

Pieprasījums izdevās, bet starpniekserveris (piemēram, kešošanas vai transformējošs starpniekserveris) modificēja noslodzi no izcelsmes servera — piemēram, bilde pārkompresējusies. Praktiski reto.

RFC 9110 ↗
204

Bez satura

Pieprasījums izdevās, bet atbildes ķermenis nav.

Bieži izmantots DELETE darbībām vai PUT atjauninājumiem, kuriem nav jāatgriež ķermenis. Klients nedrīkst doties prom no pašreizējās lapas.

RFC 9110 ↗
205

Atiestatīt saturu

Pieprasījums izdevās; klients ir jāatiestatīja dokumenta skats.

Līdzīgi kā 204, ķermenis netiek atgriezts — bet klients papildus tiek informēts atiestatīt formu vai skatu, kas radīja pieprasījumu (piem., notīrīt formas laukus nākamajam ierakstam).

RFC 9110 ↗
206

Daļējs saturs

Serveris piegādāja tikai daļu no resursa.

Atbilde uz Range pieprasījumu. Izmanto video atskaņotāji un lejupielādes pārvaldnieki, lai atsāk pārtrauktas lejupielādes vai straumējošu lielas datnes.

RFC 9110 ↗
207

Vairāki statusi

Atbildes ķermenis satur vairākus vairāku darbību statusa kodusus.

WebDAV: XML ķermenis ziņo par vairāku apakšdarbību rezultātu neatkarīgi — piem., grupveida pārvietošanu, kur daži vienumi izdevās un citi neizdevās.

RFC 4918 ↗
208

Jau ziņots

Kolekcijas dalībnieki jau tika uzskaitīti agrāk atbildē.

WebDAV: izmantots 207 Multi-Status atbildēs, lai izvairītos no vienas un tās pašas kolekcijas dalībnieku atkārtota uzskaitījuma, kad saistības rada cilpas.

RFC 5842 ↗
226

IM izmantots

Atbilde ir instances manipulāciju rezultāts, kas piemērots resursam.

Delta kodēšana: serveris atgriež atšķirību pret iepriekšējo versiju, nevis pilnu resursu, kas ietaupa joslu platumu. Ļoti reti realizēts.

RFC 3229 ↗
300

Vairākas izvēles

Ir pieejami vairāki resursa pārstāvniecības.

Serveris piedāvā vairākas iespējas (piem., dažādus formātus vai valodas) un klients jāizvēlas viena. Reti izmantots, jo automātiska satura vienošana parasti to apstrādā.

RFC 9110 ↗
301

Pavisam pārvietots

Resurss pavisam pārvietojās uz jaunu URL.

Izmantojiet pastāvīgām URL izmaiņām — meklēšanas dzinēji atjauninās savu indeksu. SEO autoritāte tiek pārnesta uz jauno URL.

RFC 9110 ↗
302

Atrasts (pagaidu pāradresācija)

Resurss pagaidām atrodas cita URL.

Norāda, ka pāradresācija nav pastāvīga. Kešošana ir mazāk agresīva nekā 301. Izmantojiet tādām lietām kā 'nepieciešama pieteikšanās, pāradresē uz /login'.

RFC 9110 ↗
303

Skatīt citu

Pāradresācija uz citu URL, izmantojot GET.

Izmantots pēc POST iesūtīšanas — atbilde saka 'jūsu POST izdevās, skatiet šī GET URL rezultātu'. Pārlūki vienmēr iegūst jauno URL.

RFC 9110 ↗
304

Nav modificēts

Kešotā versija joprojām ir derīga; izmantojiet to.

Atbilde uz nosacījuma pieprasījumu (ar If-None-Match vai If-Modified-Since galvenēm). Ietaupa joslu platumu — ķermenis netiek atgriezts.

RFC 9110 ↗
307

Pagaidu pāradresācija

Tāpat kā 302, bet saglabā oriģinālo HTTP metodi.

Ja oriģināls bija POST, pāradresācija arī izmanto POST. Moderns 302 alternatīvs, ja metodes saglabāšana ir svarīga.

RFC 9110 ↗
308

Pastāvīga pāradresācija

Tāpat kā 301, bet saglabā oriģinālo HTTP metodi.

Moderns 301 aizstājējs, ja vēlaties, lai POST pieprasījumi pēc pāradresācijas paliktu POST.

RFC 9110 ↗
400

Nepareizs pieprasījums

Serveris nespēja saprast pieprasījumu nepareizas sintakses dēļ.

Parastie cēloņi: nepareizs JSON ķermenī, nederīgi vaicājuma parametri vai trūkst nepieciešamie lauki. Pārbaudiet pieprasījuma ķermeni un galvenes.

RFC 9110 ↗
401

Neautorizēts

Autentifikācija ir nepieciešama un nav sniegta.

Klients jāiekļauj autentifikācijas kredenciāli (Authorization galvene, sīkdatne, žetonu). 'Neautorizēts' ir nepareiza terminoloģija — tas patiešu nozīmē 'neautentificēts'.

RFC 9110 ↗
402

Maksājums nepieciešams

Rezervēts nākotnes lietošanai — dažreiz izmantots par samaksātiem API līmeņiem.

Sākotnēji paredzēts ciparu maksājumiem. Moderns lietojums: API dažreiz atgriež 402, kad lietotājs pārsniedz apmaksāto kvotu.

RFC 9110 ↗
403

Aizliegts

Klients ir autentificēts, bet nav atļaujas.

Atšķirībā no 401 — lietotājs IR pieteicies, bet viņa kontam nav atļaujas šajā resursā. Pārbaudiet lomu/atļauju loģiku.

RFC 9110 ↗
404

Netika atrasts

Pieprasītais resurss neeksistē.

Vai URL ir nepareizs, resurss tika dzēsts, vai tas nekad neeksistēja. Serveri dažkārt atgriež 404, lai paslēptu, ka 403 būtu preciīzāks.

RFC 9110 ↗
405

Metode nav atļauta

Šajā resursā nav atļauta izmantotā HTTP metode.

Piemēram, GET pieprasījums galapunktam, kas pieņem tikai POST. Atbildē jāiekļauj Allow galvene, kurā norādītas derīgas metodes.

RFC 9110 ↗
406

Nav pieņemams

Neviena pārstāvniecības neatbilst klienta Accept galvenēm.

Klients pieprasīja satura veidu, valodu vai kodējumu (caur Accept, Accept-Language, Accept-Encoding), ko serveris nevar apmierināt. Daudzi serveri izlaiž stingru vienošanos un atgriež noklusējumu.

RFC 9110 ↗
407

Starpniekservera autentifikācija nepieciešama

Klients vispirms jāautentificē proxy serverim.

Tāpat kā 401, bet izsniegts ar starpniekserveri: klients jāsūta Proxy-Authorization kredenciāli. Redzams uzņēmuma tīklos ar autentificējošiem starpniekserver.

RFC 9110 ↗
408

Pieprasījuma Noildze

Serveris noildza, gaidot pieprasījumu.

Klients pārāk ilgi sūtīja pieprasījuma saturu vai turēja savienojumu dīkstāvē. Mēģiniet vēlreiz.

RFC 9110 ↗
409

Konflikts

Pieprasījums ir pretrunā ar resursa pašreizējo stāvokli.

Parasti tiek atgriezts vienlaicīgu rediģēšanas konfliktu vai dublējošu resursu izveidošanas gadījumos (piemēram, lietotāja izveide ar jau esošu e-pasta adresi).

RFC 9110 ↗
410

Pazudis

Resurss tika dzēsts un vairs neatgriezīsies.

Spēcīgāks par 404 — serveris skaidri zina, ka resurss KĀDREIZ EKSISTĒJA, bet tagad ir neatgriezeniski noņemts. Meklēšanas sistēmas to noņems no indeksa.

RFC 9110 ↗
411

Nepieciešams Garums

Serveris prasa Content-Length virsrakstu.

Pieprasījums tika noraidīts, jo tam trūka Content-Length virsraksta un serveris noraidīja nezināma izmēra saturu. Pievienojiet virsrakstu un mēģiniet vēlreiz.

RFC 9110 ↗
412

Priekšnoteikums Neizdevās

Nosacījums pieprasījuma virsrakstos netika izpildīts.

Atgriežts, ja nosacījuma virsraksti, piemēram, If-Match vai If-Unmodified-Since, neizdevās — parasti optimistisks bloķēšanas: kāds cits mainīja resursu kopš jūsu versijas. Pārkārtojiet un mēģiniet vēlreiz.

RFC 9110 ↗
413

Noslodze Pārāk Liela

Pieprasījuma saturs pārsniedz servera izmēra ierobežojumu.

Bieži notiek lielu failu augšupielādes gadījumā. Servera konfigurācija (nginx, apache) nosaka maksimālo satuma lielumu. Pārbaudiet servera konfigurāciju.

RFC 9110 ↗
414

URI Pārāk Garš

Pieprasījuma URL pārsniedz servera garuma ierobežojumu.

Parasti izraisīts ļoti garu vaicājuma virkņu (piemēram, datu kodēšana GET). Pārslēdzieties uz POST saturu vai paaugstiniet servera ierobežojumu, ja tas ir jūsu kontrolē.

RFC 9110 ↗
415

Neatbalstīts Satura Tips

Serveris nevar apstrādāt sūtīto Content-Type.

Piemēram, application/xml sūtīšana serverim, kas pieņem tikai application/json. Pareizi iestatiet Content-Type virsrakstu.

RFC 9110 ↗
416

Diapazons Nav Apmierināms

Pieprasītais baitu diapazons atrodas ārpus resursa lieluma.

Range virsraksts prasa daļu, kas faila nav — piemēram, lejupielādes atsākšana pēc faila beigām. Atbildē jāiekļauj Content-Range ar faktisko lielumu.

RFC 9110 ↗
417

Gaidīšana Neizdevās

Serveris nevar izpildīt Expect virsraksta prasības.

Sūtīts, ja serveris neatbalsta Expect: 100-continue. Daži klienti pēc noklusējuma sūta šo virsrakstu lielajos POST pieprasījumos; tā atspējošana parasti atrisina kļūdu.

RFC 9110 ↗
418

Es Esmu Tējkannas

Serveris atsakās ražot kafiju, jo ir tējkanna.

Aprīļa muļķu joks no 1998. gada (RFC 2324). Daži reāli API to izmanto jokiem vai nolīgtu galapunktu atzīmēšanai. Neizmantojiet ražošanā.

RFC 2324 ↗
421

Nepareizi Virzīts Pieprasījums

Pieprasījums tika sūtīts serverim, kas nespēj uz to atbildēt.

Bieži ar HTTP/2 savienojuma atkārtotu lietošanu: pieprasījums sasniedza serveri, kurš nav konfigurēts mērķa resursdatorniekam. Klients jāpamēģina no jauna ar jaunu savienojumu.

RFC 9110 ↗
422

Neapstrādājams Saturs

Pieprasījums bija sintaktiski pareizs, bet semantiski nepareizs.

Piemēram, JSON pareizi parsēts, bet trūkst obligātā lauka vai lauka vērtība ir ārpus diapazona. Raksturīgi REST API validācijas atbildēm.

RFC 9110 ↗
423

Bloķēts

Resurss ir bloķēts.

WebDAV: avota vai galapunkta resurss ir bloķēts ar citu klientu, tāpēc operācija nevar turpināties. Gaidiet, līdz bloķējums tiek atbrīvots, vai salūziet to ar pareizo marķieri.

RFC 4918 ↗
424

Atkarīga Neizdevusies

Pieprasījums neizdevās, jo iepriekšējais atkarīgais pieprasījums neizdevās.

WebDAV: atkarīgu operāciju ķēdē agrāka darbība neizdevās, tāpēc šī netika veikta. Skatiet agrāko neveiksmi, lai atrastu saknes cēloni.

RFC 4918 ↗
425

Pārāk Agri

Serveris atsakās apstrādāt pieprasījumu, kas varētu tikt atkārtots.

Saistīts ar TLS 1.3 0-RTT (agrīnajiem datiem): serveris neriskēs apstrādāt iespējamo atkārtoto pieprasījumu. Klients jāmēģina pēc rokas pabeigšanas.

RFC 8470 ↗
426

Nepieciešama Jaunināšana

Klients jāpārslēdz uz citu protokolu.

Serveris atsakās servēt pieprasījumu pēc pašreizējā protokola, bet darīs pēc jaunināšanas — atbilde iekļauj Upgrade virsrakstu ar nepieciešamo protokolu.

RFC 9110 ↗
428

Nepieciešams Priekšnoteikums

Serveris prasa, lai pieprasījums būtu nosacīts.

Serveris prasa nosacījuma virsrakstus (piemēram, If-Match), lai novērstu zaudētu atjauninājumu konfliktus. Noskaidrojiet resursu, uztveriet tā ETag, un pārsūtiet ar If-Match.

RFC 6585 ↗
429

Pārāk Daudz Pieprasījumu

Klients tiek ātruma ierobežots.

Palēniniet. Atbildē jāiekļauj Retry-After virsraksts, norādot, kad mēģināt vēlreiz. Bieži ar API, kuriem ir pieprasījumu kvotes.

RFC 6585 ↗
431

Pieprasījuma Virsraksti Pārāk Lieli

Virsraksti ir pārāk lieli serverim apstrādāt.

Vai nu viens virsraksts, vai kopējais virsraksta lielums pārsniedz ierobežojumu — visbiežāk izraisīts par lieliem sīkdatņiem. Notīriet sīkdatnes vai samaziniet to, ko jūsu lietotne tajās uzglabā.

RFC 6585 ↗
451

Neiespējams Dēļ Nolēmuma

Piekļuve noliegta nolēmuma prasību dēļ.

Resurss ir bloķēts nolēmuma iemeslu dēļ — sensūra, tiesas nolēmumi vai reģionālie noteikumi. Skaitlis saucas uz romānu Fārenheita 451.

RFC 7725 ↗
500

Iekšēja Servera Kļūda

Serveris sastapa neparedzētu nosacījumu.

Vispārīgs servera sānu kļūdu uztveršanas punkts. Pārbaudiet servera žurnālus faktiskā cēloni: neapstrādāts izņēmums, datubāzes kļūda utt.

RFC 9110 ↗
501

Nav Īstenots

Serveris neatbalsta pieprasīto funkcionalitāti.

Piemēram, serveris neatzīst HTTP metodi. Praktiski reti — biežāk redzēsiet 405.

RFC 9110 ↗
502

Nepareizs Vārtnis

Serveris, darbojoties kā vārtnis, saņēma nepareizu atbildi no augšpuses servera.

Bieži mikroservisu arhitektūrā. Jūsu slodzes balanseris vai reverss proxy saņēma nepareizu atbildi no aizmugures servisa.

RFC 9110 ↗
503

Serviss Nav Pieejams

Serveris šobrīd nevar apstrādāt pieprasījumu.

Vai nu apjomīgs apkope, vai pārslogots. Atbildē jāiekļauj Retry-After virsraksts. Bieži atgriežts izvietošanas laikā.

RFC 9110 ↗
504

Vārtņa Noildze

Vārtņa serveris noildza, gaidot augšpuses atbildi.

Aizmugures serviss nav pietiekami ātri atbildējis. Pārbaudiet augšpuses servisa veselību un noildzes konfigurācijas.

RFC 9110 ↗
505

HTTP Versija Nav Atbalstīta

Serveris neatbalsta pieprasījumā izmantoto HTTP versiju.

Pieprasījuma galvenā HTTP versija nav atbalstīta no servera. Praktiski nekad neredz ar modernajiem klientiem.

RFC 9110 ↗
506

Variants Arī Negociē

Serverim ir satura negociācijas nepareiza konfigurācija.

Caurspīdīga satura negociācija beidzas cilpā: izvēlētais variants pats par sevi ir konfigurēts negocēm. Norāda uz servera konfigurācijas kļūdu.

RFC 2295 ↗
507

Nepietiekama Krātuve

Serverim pietrūkst diska vietas.

WebDAV-specifisks pēc izcelsmes, bet dažkārt izmantots kopējiem serveriem. Nozīmē, ka serveris nevar saglabāt pieprasījumu glabāšanas ierobežojumu dēļ.

RFC 4918 ↗
508

Cilpa Atklāta

Serveris atklāja bezgalīgu cilpu apstrādes laikā.

WebDAV: apstrādājot Depth: infinity pieprasījumu, ieveda cilpu (piemēram, apļveida saistības). Operācija tika pārtraukta.

RFC 5842 ↗
510

Nav Paplašināts

Nepieciešami turpmāki pieprasījuma paplašinājumi.

No novecojušā HTTP paplašinājuma ietvara: serverim nepieciešama vairāk informācijas, pirms tas var izpildīt pieprasījumu. Efektīvi neizmantots modernajā tīmeklī.

RFC 2774 ↗
511

Nepieciešama Tīkla Autentifikācija

Klients jāautentificē, lai iegūtu tīkla piekļuvi.

Izmantots uļķa portāļos (viesnīca/lidosta WiFi), lai norādītu, ka lietotājam jāielogojas tīklā, pirms piekļūst ārējām vietnēm.

RFC 6585 ↗

Biežākie lietojumi

  • Atsauce API dizainamProjektējot REST API, katrai atbildei izvēlieties pareizo statusa kodu.
  • Ātri meklējiet kļūdu kodusKad jūsu lietojumprogramma atgriež mulsinoši HTTP kļūdu, meklējiet, ko tas faktiski nozīmē.
  • Uzziniet HTTP statusu kodieiusVisaptveroša atsauce studentiem un izstrādātājiem, kas mācās HTTP un REST.
  • Ātra atsauce ražošanas incidenta laikāRažošanas incidenta laikā ātri meklējiet, ko nozīmē katrs statusa kods.
  • Atsauce API dokumentācijaiRakstot API dokumentāciju, saistieties ar autoritatīviem jūsu atgrieztajiem statusa kodu aprakstiem.

Kā tas darbojas

Šis rīks ir klienta puses atsauce, veidota ap fiksētu meklēšanas tabulu ar 63 HTTP statusa kodiem, kas aptver visas piecas klases (1xx–5xx), katrs anotēts ar tā definējošo RFC numuru. Nav servera izsaukuma, nav ārējas API, nav tīkla pieprasījuma — visa filtrēšana un attēlošana notiek pārlūkprogrammā, izmantojot JavaScript iebūvētās masīvu un virkņu metodes.

  1. 1
    Meklēšanas tabula tiek ielādēta
    Pilns 63 IANA reģistrēto statusa kodu kopums ir iestrādāts tieši šajā rīkā kā JavaScript masīvs, katrs ieraksts nesot skaitlisko kodu, kanonisko angļu nosaukumu, kategorijas klasi un konkrēto RFC, kas to definē (piemēram, RFC 9110 lielākajai daļai HTTP/1.1 kodu, RFC 6585 429 Too Many Requests, RFC 2324 418 I'm a Teapot).
  2. 2
    Filtrs darbojas atmiņā
    Kamēr rakstāt vai izvēlaties kategorijas filtru, JavaScript Array.filter darbojas uz atmiņā esošā saraksta, salīdzinot jūsu vaicājumu ar statusa koda numuru, kanonisko nosaukumu un gan īsā, gan garā apraksta virknēm, izmantojot String.includes — bez atlikšanas aiztures, bez servera saziņas.
  3. 3
    Detaļas izplešas ar RFC saiti
    Katrs rezultāts tiek renderēts kā HTML details/summary elements. Ieraksta izvēršana atklāj pilnu formas skaidrojumu un tiešu saiti uz autoritatīvo RFC vietnē rfc-editor.org, tāpēc varat izlasīt precīzu specifikācijas tekstu jebkuram kodam.
  4. 4
    Dziļās saites un starpliktuves kopēšana
    Ieraksta atvēršana atjaunina URL fragmentu uz koda numuru (piemēram, #404), padarot lapu koplietojamu un piemērotu grāmatzīmēm. Kopēšanas poga ieraksta kanonisko virkni (piemēram, '404 Not Found') starpliktuvē caur pārlūkprogrammas navigator.clipboard API.

Saistītie rīki

Bieži uzdotie jautājumi