Referință de coduri de stare HTTP
| Cod | Nume | Semnificație |
|---|---|---|
| 100 | Continuă | Clientul ar trebui să continue cu corpul cererii |
| 101 | Schimbare de protocoale | Actualizare de protocol acceptată (de ex. la WebSocket) |
| 200 | OK | Cererea a reușit — răspunsul de succes implicit |
| 201 | Creat | O resursă nouă a fost creată (succes tipic POST) |
| 202 | Acceptat | În coadă pentru procesare asincronă, încă nefinalizat |
| 204 | Fără conținut | Succes cu un corp în mod intenționat gol |
| 301 | Mutat permanent | Resursa are un URL permanent nou — actualizează linkurile; capitalul SEO se transferă |
| 302 | Găsit | Redirecționare temporară (folosită greșit istoric; vezi 303/307) |
| 303 | Vezi altul | Redirecționare la un GET la alt URL (post/redirect/get) |
| 304 | Nemodificat | Copia din cache este încă validă — revalidează prin ETag/Last-Modified |
| 307 | Redirecționare temporară | Redirecționare temporară care păstrează metoda și corpul |
| 308 | Redirecționare permanentă | Redirecționare permanentă care păstrează metoda și corpul |
| 400 | Cerere greșită | Serverul nu poate analiza/înțelege cererea |
| 401 | Neautorizat | Autentificare necesară sau eșuată (în ciuda numelui, înseamnă neautentificat) |
| 403 | Interzis | Autentificat sau nu, accesul este refuzat |
| 404 | Nu a fost găsit | Nicio resursă la acest URL |
| 405 | Metodă nepermisă | Metoda HTTP nu este acceptată pentru această resursă |
| 406 | Neacceptabil | Nicio reprezentare nu corespunde anteturilor Accept |
| 408 | Timp de așteptare al cererii expirat | Clientul a durat prea mult să trimită cererea |
| 409 | Conflict | Conflict de stare, de ex. coliziune la editare sau creare duplicată |
| 410 | Dispărut | Eliminat permanent (mai puternic decât 404 — folosit deliberat) |
| 411 | Lungime necesară | Antetul Content-Length este obligatoriu |
| 413 | Conținut prea mare | Corpul cererii depășește limitele serverului |
| 414 | URI prea lung | URL-ul depășește limitele serverului |
| 415 | Tip media neacceptat | Tipul de conținut al cererii nu este acceptat |
| 418 | Sunt un ceainic | Cod de glumă RFC 2324, folosit ocazional pentru a refuza prepararea cafelei |
| 422 | Conținut neprocesabil | Sintaxa este în regulă, dar semantica eșuează la validare (API-urile adoră asta) |
| 425 | Prea devreme | Serverul refuză să proceseze o cerere posibil rejucată |
| 429 | Prea multe cereri | Limită de rată atinsă — retrage-te, respectă Retry-After |
| 500 | Eroare internă a serverului | Eroare generică de server |
| 501 | Neimplementat | Serverul nu acceptă funcționalitatea |
| 502 | Gateway defect | Un proxy/gateway a primit un răspuns invalid din amonte |
| 503 | Serviciu indisponibil | Supraîncărcat sau oprit pentru întreținere — adesea temporar, poate include Retry-After |
| 504 | Timp de așteptare al gateway-ului expirat | Un proxy/gateway a expirat așteptând răspunsul din amonte |
| 505 | Versiune HTTP neacceptată | Versiunea HTTP din cerere nu este acceptată |
Despre
Codurile de stare sunt rezumatul cu un singur număr al serverului pentru fiecare răspuns, grupate pe clasă: 1xx informațional, 2xx succes, 3xx redirecționare, 4xx clientul a greșit, 5xx serverul a greșit. Tabelul dă codurile pe care dezvoltatorii care lucrează le întâlnesc de fapt, cu nuanțele care contează în practică — 401 înseamnă neautentificat în ciuda numelui său, 403 este un refuz indiferent de autentificare, 422 este eșecul de validare API, 429 cere backoff. Codurile nelistate (coada lungă de 1xx și coduri experimentale) sunt suficient de rare încât clasa singură îți spune cum să le gestionezi.
Întrebări frecvente
Care este diferența dintre 401 și 403?
401: nu știm cine ești (autentifică-te). 403: știm, și tot nu ai voie.
302 sau 307 pentru o redirecționare temporară?
307 păstrează metoda și corpul; 302 le-a permis istoric clienților să schimbe POST în GET. Lucrările noi ar trebui să folosească 307 (sau 308 pentru permanent).