Referință Coduri de Stare HTTP — gratuit

Utilizat pentru solicitările cu Expect: 100-continue. Serverul recunoaște că este dispus să primească corpul înainte ca clientul să îl trimită. Rareori văzut în aplicațiile web moderne.

Cel mai frecvent utilizat pentru upgrade-uri WebSocket — clientul solicită Upgrade: websocket și serverul răspunde cu 101 pentru a comuta.

Un răspuns intermediar WebDAV trimis pentru a preveni expirarea timpului pe client în timpul operațiunilor lungi. Depreciat — serverele moderne nu ar trebui să îl trimită.

Permite serverelor să trimită antetele Link (preload/preconnect) în timp ce răspunsul final este încă în pregătire, pentru ca browserele să poată începe să descarce activele critice mai devreme.

Răspunsul standard de succes. Semnificația depinde de metoda HTTP: GET → resursă returnată, POST/PUT → acțiune completată.

Comun după POST. Răspunsul ar trebui să includă un antet Location care indică URL-ul noii resurse.

Pentru operațiuni asincrone — serverul pune în coadă de așteptare munca. Clientul ar trebui să sondeze un punct final de stare sau să verifice mai târziu.

Solicitarea a reușit, dar un intermediar (cum ar fi un proxy de caching sau de transformare) a modificat sarcina utilă din serverul de origine — de exemplu, recomprimarea imaginilor. Rar în practică.

Adesea utilizat pentru operațiunile DELETE sau pentru actualizările PUT care nu trebuie să returneze un corp. Clientul nu ar trebui să se îndepărteze de pagina actuală.

Ca 204, nu este returnat niciun corp — dar clientul este, de asemenea, anunțat să reseteze formularul sau vizualizarea care a produs solicitarea (ex. șterge câmpurile formularului pentru următoarea intrare).

Răspuns la o solicitare Range. Utilizat de playerele video și managerii de descărcări pentru a relua descărcările întrerupte sau pentru a transmite fișiere mari.

WebDAV: un corp XML raportează rezultatul mai multor sub-operații în mod independent — ex. o mutare în masă unde unele articole au reușit și altele au eșuat.

WebDAV: utilizat în răspunsurile 207 Multi-Status pentru a evita listarea repetată a membrilor aceleiași colecții când legăturile creează bucle.

Codificare delta: serverul returnează o diferență comparativ cu o versiune anterioară în loc de resursa completă, economisind lățimea de bandă. Foarte rar implementat.

Serverul oferă mai multe opțiuni (ex. formate sau limbi diferite) și clientul ar trebui să aleagă una. Rareori utilizat, deoarece negocierea de conținut automată de obicei rezolvă aceasta.

Utilizează pentru schimbări permanente de URL — motoarele de căutare își vor actualiza indexul. Autoritatea SEO se transferă la noua adresă URL.

Indică faptul că redirecționarea nu este permanentă. Cache-ul este mai puțin agresiv decât 301. Utilizează pentru lucruri precum 'login necesar, redirecționare la /login'.

Utilizat după trimiteri POST — răspunsul spune 'POST-ul dvs. a funcționat, consultați această adresă URL GET pentru rezultat'. Browserele întotdeauna fac GET la noua adresă URL.

Răspuns la o solicitare condiționată (cu antetele If-None-Match sau If-Modified-Since). Economisește lățimea de bandă — nu este returnat niciun corp.

Dacă originalul era POST, redirecționarea utilizează și POST. Alternativa modernă la 302 când păstrarea metodei contează.

Înlocuitor modern pentru 301 când dorești ca solicitările POST să rămână POST după redirecționare.

Cauze comune: JSON malformat în corp, parametri de interogare nevalizi sau câmpuri necesare lipsă. Verifică corpul și antetele solicitării.

Clientul trebuie să includă credențiale de autentificare (antet Authorization, cookie, token). 'Neautorizat' este o denumire greșită — de fapt înseamnă 'neautentificat'.

Intenționat pentru plăți digitale. Utilizare modernă: API-urile uneori returnează 402 când un utilizator și-a depășit cota plătită.

Diferit de 401 — utilizatorul ESTE conectat, dar contul său nu are permisiune pentru această resursă. Verifică logica rolului/permisiunilor.

Fie adresa URL este greșită, resursa a fost ștearsă, fie nu a existat niciodată. Serverele uneori returnează 404 pentru a ascunde faptul că 403 ar fi mai precis.

De exemplu, o solicitare GET la un punct final care acceptă doar POST. Răspunsul ar trebui să includă un antet Allow care listează metodele valide.

Clientul a solicitat un tip de conținut, limbă sau codificare (prin Accept, Accept-Language, Accept-Encoding) pe care serverul nu o poate satisface. Mulți serveri omit negocierea strictă și returnează o valoare implicită.

Ca 401, dar emis de o proxy: clientul trebuie să trimită credențiale Proxy-Authorization. Văzut pe rețelele corporative cu proxy-uri cu autentificare.

Clientul a durat prea mult timp pentru a trimite corpul cererii sau a ținut conexiunea inactiv. Încercați din nou cererea.

De obicei returnat pentru conflicte de editare concomitente sau crearea de resurse duplicate (de ex., crearea unui utilizator cu un email care deja există).

Mai puternic decât 404 — serverul știe în mod explicit că resursa A EXISTAT dar a fost eliminată permanent. Motoarele de căutare vor dezindexa.

Cererea a fost respinsă deoarece lipsea antetul Content-Length și serverul refuză corpuri de dimensiune necunoscută. Adăugați antetul și reîncercați.

Returnat când antetele condiționale cum ar fi If-Match sau If-Unmodified-Since eșuează — de obicei blocarea optimistă: altcineva a schimbat resursa de la versiunea dvs. Refaceți și reîncercați.

Frecvent atunci când încărcați fișiere mari. Configurația serverului (nginx, apache) stabilește o dimensiune maximă a corpului. Verificați configurația serverului.

De obicei cauzat de șiruri de interogare foarte lungi (de ex. codificarea datelor într-un GET). Treceți la un corp POST, sau ridicați limita serverului dacă îl controlați.

De exemplu, trimiterea application/xml la un server care acceptă doar application/json. Setați corect antetul Content-Type.

Antetul Range cere o porțiune pe care fișierul nu o are — de ex. reluarea unei descărcări dincolo de sfârșitul fișierului. Răspunsul ar trebui să includă Content-Range cu dimensiunea reală.

Trimis când serverul nu acceptă Expect: 100-continue. Unii clienți trimit acest antet în mod implicit pe POST-uri mari; dezactivarea acestuia rezolvă de obicei eroarea.

O glumă de 1 aprilie din 1998 (RFC 2324). Unele API-uri reale o folosesc pentru glume sau pentru a marca punctele finale depreciate. Nu pentru utilizare în producție.

Frecvent cu reutilizarea conexiunilor HTTP/2: cererea a ajuns la un server care nu este configurat pentru gazda țintă. Clientul ar trebui să reîncerce pe o nouă conexiune.

De exemplu, JSON analizat corect dar un câmp obligatoriu lipsea, sau o valoare a câmpului era în afara intervalului. Frecvent în răspunsurile de validare ale API-ului REST.

WebDAV: resursa sursă sau destinație este blocată de alt client, deci operația nu poate continua. Așteptați ca blocarea să fie eliberată sau spargeți-o cu token-ul potrivit.

WebDAV: într-un lanț de operații dependente, o acțiune anterioară a eșuat, deci aceasta nu a fost efectuată. Uitați-vă la eșecul anterior pentru cauza principală.

Legat de TLS 1.3 0-RTT (date timpurii): serverul nu va risca procesarea unei cereri posibil reluate. Clientul ar trebui să reîncerce după finalizarea handshake-ului.

Serverul refuză să servească cererea peste protocolul curent dar va face după o actualizare — răspunsul include un antet Upgrade care numește protocolul necesar.

Serverul cere antetele condiționale (cum ar fi If-Match) pentru a preveni conflictele de actualizare pierdute. Refaceți resursa, capturați ETag-ul acesteia și retrimiteți cu If-Match.

Încetiniți. Răspunsul ar trebui să includă un antet Retry-After indicând când să reîncercați. Frecvent cu API-urile care au cote de cereri.

Fie un antet, fie dimensiunea totală a antetului depășește limita — cel mai adesea cauzat de cookie-uri supradimensionate. Ștergeți cookie-urile sau reduceți ceea ce aplicația dvs. stochează în acestea.

Resursa este blocată din motive legale — cenzură, ordine judecătorești sau reglementări regionale. Numărul este o referință la romanul Fahrenheit 451.

O captură generică pentru erorile pe partea serverului. Verificați jurnalele serverului pentru cauza reală: excepție netratată, eroare de bază de date, etc.

De exemplu, serverul nu recunoaște metoda HTTP. Rar în practică — mai adesea veți vedea 405.

Frecvent în arhitecturi de microservicii. Echilibratorul de sarcină sau proxy invers a primit un răspuns malformat de la serviciul de backend.

Fie în jos pentru întreținere, fie supraîncărcat. Răspunsul ar trebui să includă un antet Retry-After. Adesea returnat în timpul implementărilor.

Serviciul de backend nu a răspuns suficient de repede. Verificați sănătatea serviciului upstream și configurațiile timeout.

Versiunea majoră HTTP a cererii nu este acceptată de server. Aproape niciodată nu se vede cu clienți moderni.

Negocierea conținutului transparent s-a încheiat într-o buclă: varianta aleasă este configurată ea însăși pentru a negocia. Indică o eroare de configurație a serverului.

Specific WebDAV în origine, dar uneori utilizat de servere generale. Înseamnă că serverul nu poate salva cererea din cauza constrângerilor de stocare.

WebDAV: procesarea unei cereri Depth: infinity a intrat într-o buclă (de ex. legări circulare). Operația a fost terminată.

Din Framework-ul de Extensie HTTP obsolet: serverul necesită mai multe informații înainte de a putea îndeplini cererea. Efectiv nefolosit pe webul modern.

Utilizat de portalurile captive (WiFi hotel/aeroport) pentru a indica că utilizatorul trebuie să se conecteze la rețea înainte de a accesa site-uri externe.