Riferimento codici di stato HTTP
| Codice | Nome | Significato |
|---|---|---|
| 100 | Continua | Il client dovrebbe continuare con il corpo della richiesta |
| 101 | Cambio protocolli | Aggiornamento protocollo accettato (es. a WebSocket) |
| 200 | OK | La richiesta è riuscita — la risposta di successo predefinita |
| 201 | Creato | Una nuova risorsa è stata creata (tipico successo POST) |
| 202 | Accettato | In coda per elaborazione asincrona, non ancora completo |
| 204 | Nessun contenuto | Successo con un corpo intenzionalmente vuoto |
| 301 | Spostato permanentemente | La risorsa ha un nuovo URL permanente — aggiorna i link; l'equità SEO si trasferisce |
| 302 | Trovato | Reindirizzamento temporaneo (storicamente abusato; vedi 303/307) |
| 303 | Vedi altro | Reindirizzamento a un GET a un altro URL (post/redirect/get) |
| 304 | Non modificato | La copia in cache è ancora valida — rivalida tramite ETag/Last-Modified |
| 307 | Reindirizzamento temporaneo | Reindirizzamento temporaneo che conserva metodo e corpo |
| 308 | Reindirizzamento permanente | Reindirizzamento permanente che conserva metodo e corpo |
| 400 | Richiesta non valida | Il server non può analizzare/comprendere la richiesta |
| 401 | Non autorizzato | Autenticazione richiesta o fallita (nonostante il nome, significa non autenticato) |
| 403 | Vietato | Autenticato o no, l'accesso è rifiutato |
| 404 | Non trovato | Nessuna risorsa a questo URL |
| 405 | Metodo non consentito | Il metodo HTTP non è supportato per questa risorsa |
| 406 | Non accettabile | Nessuna rappresentazione corrisponde alle intestazioni Accept |
| 408 | Timeout della richiesta | Il client ha impiegato troppo tempo a inviare la richiesta |
| 409 | Conflitto | Conflitto di stato, es. collisione di modifica o creazione duplicata |
| 410 | Non più disponibile | Rimosso permanentemente (più forte di 404 — usato deliberatamente) |
| 411 | Lunghezza richiesta | L'intestazione Content-Length è obbligatoria |
| 413 | Contenuto troppo grande | Il corpo della richiesta supera i limiti del server |
| 414 | URI troppo lungo | L'URL supera i limiti del server |
| 415 | Tipo di media non supportato | Il Content-Type della richiesta non è supportato |
| 418 | Sono una teiera | Codice scherzo RFC 2324, occasionalmente usato per rifiutare di preparare caffè |
| 422 | Contenuto non elaborabile | La sintassi va bene ma la semantica fallisce la convalida (le API amano questo) |
| 425 | Troppo presto | Server non disposto a elaborare una richiesta possibilmente rigiocata |
| 429 | Troppe richieste | Limite di velocità raggiunto — arretra, onora Retry-After |
| 500 | Errore interno del server | Fallimento generico lato server |
| 501 | Non implementato | Il server non supporta la funzionalità |
| 502 | Gateway non valido | Un proxy/gateway ha ricevuto una risposta non valida dall'upstream |
| 503 | Servizio non disponibile | Sovraccarico o fermo per manutenzione — spesso temporaneo, può trasportare Retry-After |
| 504 | Timeout del gateway | Un proxy/gateway è andato in timeout in attesa dell'upstream |
| 505 | Versione HTTP non supportata | La versione HTTP nella richiesta non è supportata |
Chi siamo
I codici di stato sono il riepilogo a un numero del server di ogni risposta, raggruppati per classe: 1xx informativo, 2xx successo, 3xx reindirizzamento, 4xx il client ha sbagliato, 5xx il server ha sbagliato. La tabella dà i codici che gli sviluppatori che lavorano incontrano davvero, con le sfumature che contano in pratica — 401 significa non autenticato nonostante il suo nome, 403 è un rifiuto indipendentemente dal login, 422 è il fallimento di convalida API, 429 richiede arretramento. I codici non elencati (la lunga coda di 1xx e codici sperimentali) sono abbastanza rari che la classe da sola ti dice come gestirli.
Domande frequenti
Qual è la differenza tra 401 e 403?
401: non sappiamo chi sei (autenticati). 403: lo sappiamo, e comunque non puoi.
302 o 307 per un reindirizzamento temporaneo?
307 conserva il metodo e il corpo; 302 storicamente permetteva ai client di passare da POST a GET. I nuovi lavori dovrebbero usare 307 (o 308 per i permanenti).