Referencë Kodesh Statusi HTTP Falas

Referencë e kërkueshme për të gjitha kodet e statusit HTTP — çfarë do të thotë secili, kur përdoret dhe shkaqet e zakonshme. Nga 100 deri 511.

Funksionon jashtë linje sapo ngarkohet

61 kode statusi

100

Vazhdo

Serveri i ka marrë kokat e kërkesës dhe klienti duhet të vazhdojë me trupin.

Përdoret për kërkesa me Expect: 100-continue. Serveri konfirmon që është gati të marrë trupin para se klienti ta dërgojë. Rrallë shihet në aplikacionet moderne web.

RFC 9110 ↗
101

Ndërrim Protokolli

Serveri po ndërron protokollet siç kërkoi klienti.

Përdoret më së shpeshti për përditësime WebSocket — klienti kërkon Upgrade: websocket dhe serveri përgjigjet me 101 për të ndërruar.

RFC 9110 ↗
102

Duke përpunuar

Serveri e ka marrë kërkesën dhe po e përpunon, por ende nuk ka përgjigje të disponueshme.

Një përgjigje e ndërmjetme WebDAV e dërguar për të parandaluar timeout-et e klientit gjatë operacioneve të gjata. E vjetëruar — serverët modernë nuk duhet ta dërgojnë.

RFC 2518 ↗
103

Këshilla të Hershme

Koka paraprake të dërguara para përgjigjes përfundimtare.

U lejon serverëve të dërgojnë koka Link (preload/preconnect) ndërkohë që përgjigjja përfundimtare ende po përgatitet, kështu që shfletuesit mund të fillojnë të marrin burimet kritike më shpejt.

RFC 8297 ↗
200

OK

Kërkesa u përmbush me sukses.

Përgjigjja standarde e suksesit. Kuptimi varet nga metoda HTTP: GET → burimi u kthye, POST/PUT → veprimi u krye.

RFC 9110 ↗
201

Krijuar

U krijua me sukses një burim i ri.

E zakonshme pas një POST. Përgjigjja duhet të përfshijë një kokë Location që tregon URL-në e burimit të ri.

RFC 9110 ↗
202

U pranua

Kërkesa u pranua për përpunim, por përpunimi nuk ka përfunduar.

Për operacione asinkrone — serveri po e radhit punën. Klienti duhet të kontrollojë periodikisht një pikëfundim statusi ose të kthehet më vonë.

RFC 9110 ↗
203

Informacion Jo-Autoritar

Përgjigjja u modifikua nga një proxy transformues.

Kërkesa u përmbush, por një ndërmjetës (si një proxy caching ose transformues) e ndryshoi ngarkesën nga serveri origjinal — për shembull, duke ripakuar imazhet. E rrallë në praktikë.

RFC 9110 ↗
204

Pa Përmbajtje

Kërkesa u përmbush por nuk ka trup përgjigjeje.

Përdoret shpesh për operacione DELETE ose përditësime PUT që nuk kanë nevojë të kthejnë trup. Klienti nuk duhet të largohet nga faqja aktuale.

RFC 9110 ↗
205

Rivendos Përmbajtjen

Kërkesa u përmbush; klienti duhet të rivendosë pamjen e dokumentit.

Njësoj si 204, nuk kthehet trup — por klienti udhëzohet gjithashtu të rivendosë formularin ose pamjen që prodhoi kërkesën (p.sh. të pastrojë fushat e formularit për hyrjen tjetër).

RFC 9110 ↗
206

Përmbajtje e Pjesshme

Serveri dërgoi vetëm një pjesë të burimit.

Përgjigje ndaj një kërkese Range. Përdoret nga player-at video dhe menaxherët e shkarkimeve për të vazhduar shkarkime të ndërprera ose transmetuar skedarë të mëdhenj.

RFC 9110 ↗
207

Statuse të Shumëfishta

Trupi i përgjigjes përmban statuse të shumta për operacione të shumta.

WebDAV: një trup XML raporton rezultatin e disa nën-operacioneve në mënyrë të pavarur — p.sh. një zhvendosje në grup ku disa artikuj u kryen me sukses dhe të tjerë dështuan.

RFC 4918 ↗
208

Raportuar tashmë

Anëtarët e koleksionit ishin listuar tashmë më herët në përgjigje.

WebDAV: përdoret brenda përgjigjeve 207 Multi-Status për të shmangur listimin e përsëritur të anëtarëve të të njëjtit koleksion kur lidhjet (bindings) krijojnë sikle.

RFC 5842 ↗
226

IM e përdorur

Përgjigjja është rezultat i manipulimeve të instancës të aplikuara mbi burimin.

Kodim delta: serveri kthen një diferencë (diff) kundrejt një versioni të mëparshëm në vend të burimit të plotë, duke kursyer bandwidth. Zbatohet shumë rrallë.

RFC 3229 ↗
300

Shumë zgjedhje

Disponohen disa paraqitje të burimit.

Serveri ofron disa mundësi (p.sh. formate ose gjuhë të ndryshme) dhe klienti duhet të zgjedhë njërën. Përdoret rrallë, sepse negocimi automatik i përmbajtjes zakonisht e trajton këtë.

RFC 9110 ↗
301

Zhvendosur përgjithmonë

Burimi është zhvendosur përgjithmonë në një URL të re.

Përdoreni për ndryshime të përhershme të URL-së — motorët e kërkimit do ta përditësojnë indeksin e tyre. Autoriteti SEO kalon te URL-ja e re.

RFC 9110 ↗
302

U gjet (ridrejtim i përkohshëm)

Burimi ndodhet përkohësisht në një URL tjetër.

Tregon që ridrejtimi nuk është i përhershëm. Ruajtja në cache është më pak agresive se te 301. Përdoreni për raste si 'kërkohet hyrje, duke ridrejtuar te /login'.

RFC 9110 ↗
303

Shiko diku tjetër

Ridrejtim te një URL tjetër duke përdorur GET.

Përdoret pas dërgimeve POST — përgjigjja thotë 'POST-i juaj funksionoi, shihni këtë URL GET për rezultatin'. Shfletuesit gjithmonë bëjnë GET te URL-ja e re.

RFC 9110 ↗
304

Pa ndryshime

Versioni në cache është ende i vlefshëm; përdoreni atë.

Përgjigje ndaj një kërkese të kushtëzuar (me kokat If-None-Match ose If-Modified-Since). Kursen bandwidth — nuk kthehet asnjë trup përgjigjeje.

RFC 9110 ↗
307

Ridrejtim i përkohshëm

Ngjashëm me 302, por ruan metodën origjinale HTTP.

Nëse origjinali ishte POST, ridrejtimi përdor gjithashtu POST. Alternativë moderne ndaj 302 kur ruajtja e metodës ka rëndësi.

RFC 9110 ↗
308

Ridrejtim i përhershëm

Ngjashëm me 301, por ruan metodën origjinale HTTP.

Zëvendësues modern i 301 kur dëshironi që kërkesat POST të mbeten POST pas ridrejtimit.

RFC 9110 ↗
400

Kërkesë e gabuar

Serveri nuk arriti ta kuptojë kërkesën për shkak të sintaksës së gabuar.

Shkaqe të zakonshme: JSON i keqformuar në trup, parametra kërkimi të pavlefshëm, ose fusha të domosdoshme që mungojnë. Kontrolloni trupin e kërkesës dhe kokat.

RFC 9110 ↗
401

I paautorizuar

Kërkohet vërtetim (authentication) dhe ai nuk është dhënë.

Klienti duhet të përfshijë kredenciale vërtetimi (kokë Authorization, cookie, token). 'I paautorizuar' është term jo i saktë — në fakt do të thotë 'i pavërtetuar'.

RFC 9110 ↗
402

Kërkohet pagesë

E rezervuar për përdorim të ardhshëm — ndonjëherë përdoret për nivele API me pagesë.

Fillimisht ishte menduar për pagesa dixhitale. Përdorim modern: API-të ndonjëherë kthejnë 402 kur një përdorues ka tejkaluar kuotën e tij me pagesë.

RFC 9110 ↗
403

E ndaluar

Klienti është i vërtetuar, por nuk ka leje.

Ndryshe nga 401 — përdoruesi ËSHTË i kyçur, por llogaria e tij nuk ka leje për këtë burim. Kontrolloni logjikën e roleve/lejeve.

RFC 9110 ↗
404

Nuk u gjet

Burimi i kërkuar nuk ekziston.

Ose URL-ja është e gabuar, burimi është fshirë, ose nuk ka ekzistuar kurrë. Serverët ndonjëherë kthejnë 404 për të fshehur faktin që 403 do të ishte më i saktë.

RFC 9110 ↗
405

Metodë e palejuar

Metoda HTTP e përdorur nuk lejohet për këtë burim.

Për shembull, një kërkesë GET drejtuar një pikë fundore (endpoint) që pranon vetëm POST. Përgjigjja duhet të përfshijë një kokë Allow me metodat e vlefshme.

RFC 9110 ↗
406

Jo e pranueshme

Asnjë paraqitje nuk përputhet me kokat Accept të klientit.

Klienti kërkoi një lloj përmbajtjeje, gjuhë ose kodim (përmes Accept, Accept-Language, Accept-Encoding) që serveri nuk mund t'i sigurojë. Shumë servera anashkalojnë negocimin strikt dhe kthejnë një vlerë të parazgjedhur.

RFC 9110 ↗
407

Kërkohet vërtetim prokse (proxy)

Klienti duhet të vërtetohet fillimisht me proksin.

Ngjashëm me 401, por lëshuar nga një proksi: klienti duhet të dërgojë kredenciale Proxy-Authorization. Haset në rrjete korporative me prokse vërtetuese.

RFC 9110 ↗
408

Koha e kërkesës skadoi

Serverit i skadoi koha duke pritur kërkesën.

Klientit iu deshën shumë kohë për të dërguar trupin e kërkesës ose e mbajti lidhjen joaktive. Provojeni kërkesën përsëri.

RFC 9110 ↗
409

Konflikt

Kërkesa bie ndesh me gjendjen aktuale të burimit.

Zakonisht kthehet për konflikte redaktimi njëkohshëm ose krijim burimesh të dyfishta (p.sh. krijimi i një përdoruesi me një email që ekziston tashmë).

RFC 9110 ↗
410

U zhduk

Burimi u fshi dhe nuk do të kthehet.

Më i fortë se 404 — serveri e di në mënyrë të qartë që burimi KA EKZISTUAR më parë, por është hequr përgjithmonë. Motorët e kërkimit do ta heqin nga indeksi.

RFC 9110 ↗
411

Kërkohet gjatësia

Serveri kërkon një kokë Content-Length.

Kërkesa u refuzua sepse i mungonte koka Content-Length dhe serveri refuzon trupa me madhësi të panjohur. Shtoni kokën dhe provoni përsëri.

RFC 9110 ↗
412

Parakushti dështoi

Një kusht në kokat e kërkesës nuk u plotësua.

Kthehet kur kokat e kushtëzuara si If-Match ose If-Unmodified-Since dështojnë — zakonisht bllokim optimist (optimistic locking): dikush tjetër ka ndryshuar burimin që nga versioni juaj. Rimerreni burimin dhe provoni përsëri.

RFC 9110 ↗
413

Ngarkesa shumë e madhe

Trupi i kërkesës tejkalon kufirin e madhësisë të serverit.

E zakonshme gjatë ngarkimit të skedarëve të mëdhenj. Konfigurimi i serverit (nginx, apache) cakton një madhësi maksimale trupi. Kontrolloni konfigurimin e serverit.

RFC 9110 ↗
414

URI shumë e gjatë

URL-ja e kërkesës tejkalon kufirin e gjatësisë të serverit.

Zakonisht shkaktohet nga vargje kërkimi shumë të gjata (p.sh. kodimi i të dhënave në një GET). Kaloni te një trup POST, ose rrisni kufirin e serverit nëse e kontrolloni atë.

RFC 9110 ↗
415

Lloj mediumi i pambështetur

Serveri nuk mund të trajtojë Content-Type-in e dërguar.

Për shembull, dërgimi i application/xml te një server që pranon vetëm application/json. Vendosni saktë kokën Content-Type.

RFC 9110 ↗
416

Diapazoni nuk mund të plotësohet

Diapazoni i byte-ave të kërkuar është jashtë madhësisë së burimit.

Koka Range kërkon një pjesë që skedari nuk e ka — p.sh. rifillimi i një shkarkimi përtej fundit të skedarit. Përgjigjja duhet të përfshijë Content-Range me madhësinë aktuale.

RFC 9110 ↗
417

Pritja dështoi

Serveri nuk mund të plotësojë kërkesat e kokës Expect.

Dërgohet kur serveri nuk mbështet Expect: 100-continue. Disa klientë e dërgojnë këtë kokë si parazgjedhje në POST të mëdha; çaktivizimi i saj zakonisht zgjidh gabimin.

RFC 9110 ↗
418

Jam kafeniere

Serveri refuzon të bëjë kafe sepse është një kafeniere (teapot).

Një shaka e datës 1 prill nga viti 1998 (RFC 2324). Disa API reale e përdorin për shaka ose për të shënuar pikë fundore të vjetruara. Jo për përdorim në prodhim.

RFC 2324 ↗
421

Kërkesë e keqdrejtuar

Kërkesa u dërgua te një server që nuk mund të prodhojë një përgjigje për të.

E zakonshme me ripërdorimin e lidhjeve HTTP/2: kërkesa arriti te një server që nuk është konfiguruar për host-in e synuar. Klienti duhet ta provojë përsëri në një lidhje të re.

RFC 9110 ↗
422

Përmbajtje e papërpunueshme

Kërkesa ishte sintaksisht e vlefshme, por semantikisht e gabuar.

Për shembull, JSON-i u analizua saktë, por një fushë e domosdoshme mungonte, ose vlera e një fushe ishte jashtë intervalit. E zakonshme në përgjigjet e validimit të API-ve REST.

RFC 9110 ↗
423

I bllokuar

Burimi është i bllokuar.

WebDAV: burimi burim ose destinacion është i bllokuar nga një klient tjetër, kështu që operacioni nuk mund të vazhdojë. Prisni derisa të lirohet blloku ose thyeni atë me tokenin e duhur.

RFC 4918 ↗
424

Varësi e dështuar

Kërkesa dështoi sepse një kërkesë e mëparshme e varur dështoi.

WebDAV: në një zinxhir operacionesh të varura, një veprim i mëparshëm dështoi, prandaj ky nuk u krye. Shikoni dështimin e mëparshëm për shkakun rrënjësor.

RFC 4918 ↗
425

Shumë herët

Serveri refuzon të përpunojë një kërkesë që mund të jetë e riluajtur.

Lidhet me TLS 1.3 0-RTT (të dhëna të hershme): serveri nuk do të rrezikojë përpunimin e një kërkese potencialisht të riluajtur. Klienti duhet ta provojë përsëri pas përfundimit të handshake-ut.

RFC 8470 ↗
426

Kërkohet përditësim

Klienti duhet të kalojë në një protokoll tjetër.

Serveri refuzon të shërbejë kërkesën me protokollin aktual, por do ta bëjë pas një përditësimi — përgjigjja përfshin një kokë Upgrade që emërton protokollin e kërkuar.

RFC 9110 ↗
428

Kërkohet parakusht

Serveri kërkon që kërkesa të jetë e kushtëzuar.

Serveri kërkon kokat e kushtëzuara (si If-Match) për të parandaluar humbjen e përditësimeve. Merrni burimin, kapni ETag-un e tij dhe ridërgojeni me If-Match.

RFC 6585 ↗
429

Shumë kërkesa

Klienti është duke iu kufizuar shpejtësia (rate-limited).

Ngadalësoni. Përgjigjja duhet të përfshijë një kokë Retry-After që tregon kur të provoni përsëri. E zakonshme me API-të që kanë kuota kërkesash.

RFC 6585 ↗
431

Fushat e kokës së kërkesës shumë të mëdha

Kokat janë shumë të mëdha për t'u përpunuar nga serveri.

Ose një kokë e vetme ose madhësia totale e kokave tejkalon kufirin — shkaktohet më së shpeshti nga cookie-t e mëdha. Fshini cookie-t ose zvogëloni atë që aplikacioni juaj ruan në to.

RFC 6585 ↗
451

E paarritshme për arsye ligjore

Qasja e ndaluar për shkak kërkesash ligjore.

Burimi është i bllokuar për arsye ligjore — censurë, urdhra gjyqësorë ose rregullore rajonale. Numri i referohet romanit Fahrenheit 451.

RFC 7725 ↗
500

Gabim i brendshëm serveri

Serveri hasi një kusht të paparashikuar.

Një kategori e përgjithshme për gabime anash serveri. Kontrolloni regjistrat (logs) e serverit për shkakun e vërtetë: përjashtim i patrajtuar, gabim baze të dhënash, etj.

RFC 9110 ↗
501

Nuk është zbatuar

Serveri nuk mbështet funksionalitetin e kërkuar.

Për shembull, serveri nuk e njeh metodën HTTP. E rrallë në praktikë — më shpesh do të shihni 405.

RFC 9110 ↗
502

Portë e keqe (Bad Gateway)

Serveri, duke vepruar si portë (gateway), mori një përgjigje të gabuar nga një server prapa tij.

E zakonshme në arkitekturat me mikroshërbime. Balancuesi juaj i ngarkesës ose proksi i kundërt mori një përgjigje të keqformuar nga shërbimi prapa.

RFC 9110 ↗
503

Shërbimi jo i disponueshëm

Serveri është përkohësisht i paaftë të trajtojë kërkesën.

Ose është në mirëmbajtje, ose i mbingarkuar. Përgjigjja duhet të përfshijë një kokë Retry-After. Shpesh kthehet gjatë vendosjeve (deployments).

RFC 9110 ↗
504

Koha e portës skadoi (Gateway Timeout)

Serverit të portës i skadoi koha duke pritur një përgjigje nga shërbimi prapa.

Shërbimi prapa nuk u përgjigj mjaft shpejt. Kontrolloni shëndetin e shërbimit prapa dhe konfigurimet e kohës së pritjes.

RFC 9110 ↗
505

Versioni HTTP nuk mbështetet

Serveri nuk mbështet versionin HTTP të përdorur në kërkesë.

Versioni kryesor HTTP i kërkesës nuk mbështetet nga serveri. Pothuajse asnjëherë nuk shihet me klientë modernë.

RFC 9110 ↗
506

Varianti gjithashtu negocion

Serveri ka një keqkonfigurim të negocimit të përmbajtjes.

Negocimi transparent i përmbajtjes përfundoi në një sikël: varianti i zgjedhur është vetë i konfiguruar për të negociuar. Tregon një gabim konfigurimi në server.

RFC 2295 ↗
507

Hapësirë ruajtëse e pamjaftueshme

Serverit i ka mbaruar hapësira e diskut.

Me origjinë nga WebDAV, por ndonjëherë përdoret edhe nga serverë të përgjithshëm. Do të thotë që serveri nuk mund ta ruajë kërkesën për shkak kufizimesh ruajtjeje.

RFC 4918 ↗
508

U zbulua sikël

Serveri zbuloi një sikël të pafund gjatë përpunimit të kërkesës.

WebDAV: përpunimi i një kërkese Depth: infinity hyri në një sikël (p.sh. lidhje qarkore). Operacioni u ndërpre.

RFC 5842 ↗
510

Jo e zgjeruar

Kërkohen zgjerime të mëtejshme të kërkesës.

Nga struktura e vjetëruar HTTP Extension Framework: serveri ka nevojë për më shumë informacion para se ta plotësojë kërkesën. Praktikisht e papërdorur në ueb-in modern.

RFC 2774 ↗
511

Kërkohet vërtetim rrjeti

Klienti duhet të vërtetohet për të fituar qasje në rrjet.

Përdoret nga portalet e rrethuara (captive portals — WiFi hoteli/aeroporti) për të treguar që përdoruesi duhet të kyçet në rrjet para se të qaset në sajte të jashtme.

RFC 6585 ↗

Si funksionon

Ky mjet është një referencë nga ana e klientit e ndërtuar rreth një tabele kërkimi të paravendosur me 63 kode statusi HTTP që mbulojnë të pesë klasat (1xx–5xx), secila e shënuar me numrin RFC që e përcakton. Nuk ka thirrje serveri, nuk ka API të jashtme, dhe nuk ka kërkesë rrjeti — i gjithë filtrimi dhe shfaqja ndodh në shfletues duke përdorur metodat e integruara array dhe string të JavaScript-it.

  1. 1
    Tabela e kërkimit ngarkohet
    Bashkësia e plotë me 63 kode statusi të regjistruara IANA është e futur direkt në këtë mjet si një grup JavaScript, çdo hyrje duke bartur kodin numerik, emrin kanonik anglisht, klasën e kategorisë, dhe RFC-në specifike që e përcakton (p.sh. RFC 9110 për shumicën e kodeve HTTP/1.1, RFC 6585 për 429 Too Many Requests, RFC 2324 për 418 I'm a Teapot).
  2. 2
    Filtri xhiron në memorie
    Ndërsa shkruan ose zgjedh një filtër kategorie, Array.filter i JavaScript-it xhiron mbi listën në memorie, duke përputhur kërkesën tënde me numrin e kodit të statusit, emrin kanonik, dhe vargjet e përshkrimit të shkurtër dhe të gjatë duke përdorur String.includes — pa vonesë debounce, pa udhëtim vajtje-ardhje te serveri.
  3. 3
    Detajet zgjerohen me lidhje RFC
    Çdo rezultat vizatohet si një element HTML details/summary. Zgjerimi i një hyrjeje zbulon shpjegimin e formës së gjatë dhe një lidhje direkte te RFC-ja autoritative te rfc-editor.org, kështu që mund të lexosh tekstin e saktë të specifikimit për çdo kod.
  4. 4
    Lidhje të thella dhe kopjim te clipboard
    Hapja e një hyrjeje përditëson hash-in e URL-së te numri i kodit (p.sh. #404), duke e bërë faqen të ndashme dhe të përshtatshme për faqerojtës. Butoni i kopjimit e shkruan vargun kanonik (p.sh. '404 Not Found') te clipboard përmes API-së navigator.clipboard të shfletuesit.

Mjete të ngjashme

Pyetjet e bëra më shpesh