2xx · Successo
200
OK
La richiesta è andata a buon fine. Cosa contiene il corpo dipende dal metodo: la risorsa per un GET, il risultato dell'azione per un POST.
Quando usarlo: La risposta predefinita a una richiesta che ha funzionato. Quando è stato creato qualcosa di nuovo, 201 dice di più.
Definito in RFC 9110 §15.3.1
201
Created
La richiesta è andata a buon fine e ha creato una o più nuove risorse.
Quando usarlo: La risposta a un POST o a un PUT che ha creato qualcosa, con un'intestazione Location che punta alla nuova risorsa.
Definito in RFC 9110 §15.3.2
202
Accepted
La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è finita e può ancora fallire.
Quando usarlo: Per lavori che girano in background — un job in coda, un'importazione in blocco — idealmente con un link dove il client può controllare l'avanzamento.
Definito in RFC 9110 §15.3.3
203
Non-Authoritative Information
La richiesta è andata a buon fine, ma un proxy intermedio ha modificato la risposta ricevuta dal server di origine.
Quando usarlo: Inviato dai proxy che trasformano i contenuti, per dire che il contenuto non è esattamente quello inviato dall'origine. Si vede di rado.
Definito in RFC 9110 §15.3.4
204
No Content
La richiesta è andata a buon fine e la risposta non ha volutamente alcun corpo.
Quando usarlo: Una risposta comune a un DELETE, o a un PUT per cui il client non ha bisogno di una copia di ritorno.
Definito in RFC 9110 §15.3.5
205
Reset Content
La richiesta è andata a buon fine e il client dovrebbe azzerare la vista che l'ha inviata, per esempio svuotando un modulo.
Quando usarlo: Pensato per le interfacce di inserimento dati che vogliono il modulo vuoto per la voce successiva. In pratica i browser ne fanno poco.
Definito in RFC 9110 §15.3.6
206
Partial Content
Il server sta inviando solo la parte della risorsa che il client ha chiesto in un'intestazione Range.
Quando usarlo: È così che lo spostamento in un video, i download ripresi e i download manager scaricano un file a pezzi.
Definito in RFC 9110 §15.3.7
207
Multi-Status
Una risposta WebDAV il cui corpo XML contiene uno stato separato per ciascuna di più risorse.
Quando usarlo: Per una singola richiesta che ha agito su molti elementi, dove alcuni possono essere riusciti e altri no.
Definito in RFC 4918
208
Already Reported
Usato dentro una risposta WebDAV 207 per dire che i membri di una risorsa sono già stati elencati prima nella stessa risposta.
Quando usarlo: Evita che lo stesso elemento venga ripetuto quando una collezione è raggiungibile attraverso più di un binding.
Definito in RFC 5842
226
IM Used
Il server ha soddisfatto un GET e la risposta è il risultato di manipolazioni di istanza, come un delta, applicate alla risorsa attuale.
Quando usarlo: Fa parte del delta encoding di HTTP (RFC 3229), in cui un client chiede solo ciò che è cambiato rispetto alla sua copia. Implementato di rado.
Definito in RFC 3229
3xx · Reindirizzamento
300
Multiple Choices
La risorsa ha più rappresentazioni, e il client o l'utente dovrebbe sceglierne una.
Quando usarlo: Poco usato, perché non esiste un modo standard di scegliere automaticamente; di solito i server ne scelgono una e la inviano.
Definito in RFC 9110 §15.4.1
301
Moved Permanently
La risorsa ha un nuovo indirizzo permanente, indicato nell'intestazione Location, e i link dovrebbero essere aggiornati.
Quando usarlo: Per una pagina che si è spostata definitivamente. I motori di ricerca trasferiscono il suo posizionamento al nuovo indirizzo. Un client può trasformare un POST in un GET seguendolo, quindi usa 308 quando il metodo conta.
Definito in RFC 9110 §15.4.2
302
Found
Noto anche come: Moved Temporarily
La risorsa si trova temporaneamente a un altro indirizzo, indicato nell'intestazione Location; l'indirizzo originale resta quello giusto da usare.
Quando usarlo: Per uno spostamento breve, come mandare i visitatori a una pagina di accesso. I client possono cambiare POST in GET seguendolo; 307 lo vieta.
Definito in RFC 9110 §15.4.3
303
See Other
La risposta si trova a un altro indirizzo, e il client dovrebbe recuperarla con un GET.
Quando usarlo: La risposta classica dopo l'invio di un modulo in POST (Post/Redirect/Get), così ricaricare la pagina del risultato non reinvia il modulo.
Definito in RFC 9110 §15.4.4
304
Not Modified
La copia in cache del client è ancora aggiornata, quindi il server non invia alcun corpo.
Quando usarlo: La risposta a un GET condizionale con If-None-Match o If-Modified-Since quando non è cambiato nulla. Non è un errore: è la cache che funziona.
Definito in RFC 9110 §15.4.5
305
Use Proxy
Non in usoUn tempo diceva al client di ripetere la richiesta attraverso il proxy indicato nell'intestazione Location.
Quando usarlo: Deprecato per motivi di sicurezza, perché permetteva a una risposta di dirottare il traffico su un proxy a sua scelta. Non inviarlo.
Definito in RFC 9110 §15.4.6
306
(Unused)
Non in usoRiservato. Una bozza precedente lo definiva come Switch Proxy, e non è mai stato usato.
Quando usarlo: Non inviarlo mai. Il numero resta riservato per non essere riutilizzato.
Definito in RFC 9110 §15.4.7
307
Temporary Redirect
La risorsa si trova temporaneamente all'indirizzo dell'intestazione Location, e il client deve ripetere lì la richiesta con lo stesso metodo e lo stesso corpo.
Quando usarlo: Il reindirizzamento temporaneo da usare quando un POST deve restare un POST. Anche i passaggi da http a https imposti da HSTS compaiono nei browser come 307.
Definito in RFC 9110 §15.4.8
308
Permanent Redirect
La risorsa si è spostata definitivamente all'indirizzo dell'intestazione Location, e il client deve mantenere lo stesso metodo e lo stesso corpo.
Quando usarlo: Un reindirizzamento permanente per un'API o qualsiasi endpoint che accetta POST o PUT, dove un 301 potrebbe trasformare la richiesta in un GET.
Definito in RFC 9110 §15.4.9
4xx · Errore del client
400
Bad Request
Il server non può elaborare la richiesta per qualcosa che considera un errore del client, per esempio una sintassi malformata.
Quando usarlo: Per una richiesta che non si riesce proprio a interpretare: JSON rotto, un'intestazione non valida, un parametro obbligatorio mancante.
Definito in RFC 9110 §15.5.1
401
Unauthorized
La richiesta non ha credenziali di autenticazione valide per la risorsa. Nonostante il nome, riguarda l'autenticazione, non i permessi.
Quando usarlo: Quando il client non ha effettuato l'accesso o il suo token è scaduto. La risposta deve includere un'intestazione WWW-Authenticate che dice come autenticarsi.
Definito in RFC 9110 §15.5.2
402
Payment Required
Riservato per un uso futuro. La specifica non ha mai definito cosa debba fare.
Quando usarlo: Alcune API lo inviano quando un abbonamento è scaduto o un pagamento non è andato a buon fine, ma dietro non c'è alcun comportamento standard.
Definito in RFC 9110 §15.5.3
403
Forbidden
Il server ha capito la richiesta e si rifiuta di soddisfarla. Inviare di nuovo le stesse credenziali non cambierà la risposta.
Quando usarlo: Quando l'utente è noto ma non autorizzato: l'account di qualcun altro, una pagina di amministrazione, un paese o un indirizzo IP bloccato.
Definito in RFC 9110 §15.5.4
404
Not Found
Il server non ha nulla a questo indirizzo, o non vuole dire se ce l'ha.
Quando usarlo: La risposta a un link rotto o a un URL scritto male. Usato anche al posto di 403 per nascondere che una risorsa privata esiste. Se è sparita per sempre, lo dice 410.
Definito in RFC 9110 §15.5.5
405
Method Not Allowed
Il metodo è noto al server ma non è supportato da questa risorsa.
Quando usarlo: Per un POST a un indirizzo di sola lettura, o un DELETE dove non si può eliminare nulla. La risposta deve elencare i metodi consentiti in un'intestazione Allow.
Definito in RFC 9110 §15.5.6
406
Not Acceptable
Il server non può produrre una risposta in nessuno dei formati che il client ha dichiarato di accettare nelle intestazioni Accept.
Quando usarlo: Una negoziazione dei contenuti senza nulla in comune, come un client che accetta solo XML da un'API che parla solo JSON. La maggior parte dei server invia invece il proprio formato predefinito.
Definito in RFC 9110 §15.5.7
407
Proxy Authentication Required
Come 401, ma è un proxy tra il client e il server che ha bisogno che il client si autentichi.
Quando usarlo: Inviato dai proxy aziendali e da altri proxy con autenticazione, con un'intestazione Proxy-Authenticate che dice come fare.
Definito in RFC 9110 §15.5.8
408
Request Timeout
Il server ha smesso di aspettare che il client finisse di inviare la richiesta.
Quando usarlo: Inviato su una connessione inattiva prima che il server la chiuda. I client possono semplicemente riprovare la richiesta su una nuova connessione.
Definito in RFC 9110 §15.5.9
409
Conflict
La richiesta è in conflitto con lo stato attuale della risorsa.
Quando usarlo: Una modifica basata su una versione superata, un nome utente già preso, o il caricamento di un file il cui nome è già in uso.
Definito in RFC 9110 §15.5.10
410
Gone
La risorsa era qui ed è stata rimossa di proposito, senza un indirizzo di inoltro.
Quando usarlo: Per contenuti rimossi definitivamente. Dice ai motori di ricerca, con più decisione di 404, che la pagina non tornerà.
Definito in RFC 9110 §15.5.11
411
Length Required
Il server rifiuta una richiesta che ha un corpo ma nessuna intestazione Content-Length.
Quando usarlo: Inviato dai server che non accettano upload a blocchi di lunghezza sconosciuta.
Definito in RFC 9110 §15.5.12
412
Precondition Failed
Una condizione nelle intestazioni della richiesta, come If-Match o If-Unmodified-Since, non è stata rispettata.
Quando usarlo: Protegge dagli aggiornamenti persi: la risorsa è cambiata dall'ultima volta che il client l'ha letta, quindi la scrittura viene rifiutata.
Definito in RFC 9110 §15.5.13
413
Content Too Large
Noto anche come: Payload Too Large, Request Entity Too Large
Il corpo della richiesta è più grande di quanto il server voglia o possa gestire. La RFC 9110 lo ha rinominato da Payload Too Large.
Quando usarlo: Un upload oltre il limite di dimensione. Se il limite è temporaneo, un'intestazione Retry-After dice quando riprovare.
Definito in RFC 9110 §15.5.14
414
URI Too Long
Noto anche come: Request-URI Too Long
L'URI della richiesta è più lungo di quanto il server sia disposto a leggere.
Quando usarlo: Di solito un modulo inviato in GET con una query string enorme, o un ciclo di reindirizzamenti che continuava ad allungare l'URL. Invia invece i dati nel corpo di un POST.
Definito in RFC 9110 §15.5.15
415
Unsupported Media Type
Il server rifiuta la richiesta perché il corpo è in un formato che non supporta.
Quando usarlo: Un Content-Type sbagliato o mancante, per esempio dati di un modulo inviati a un endpoint che accetta solo application/json.
Definito in RFC 9110 §15.5.16
416
Range Not Satisfiable
Noto anche come: Requested Range Not Satisfiable
Nessuno degli intervalli nell'intestazione Range della richiesta si sovrappone alla risorsa.
Quando usarlo: Chiedere byte oltre la fine del file, spesso riprendendo il download di un file che nel frattempo è diventato più piccolo.
Definito in RFC 9110 §15.5.17
417
Expectation Failed
Il server non può soddisfare il requisito nell'intestazione Expect della richiesta.
Quando usarlo: Si vede soprattutto quando un proxy o un server non supporta Expect: 100-continue. Riprovare senza quell'intestazione di solito funziona.
Definito in RFC 9110 §15.5.18
418
(Unused)
Non in usoNoto anche come: I'm a teapot
Il codice del primo aprile della RFC 2324: una teiera che si rifiuta di fare il caffè. La RFC 9110 riserva il numero perché non gli venga mai dato un significato reale.
Quando usarlo: Non per la produzione. Alcuni siti lo inviano come easter egg o per respingere i bot, ma non ci si può aspettare che i client lo capiscano.
Definito in RFC 9110 §15.5.19
421
Misdirected Request
La richiesta ha raggiunto un server che non può produrre una risposta per l'host che indica.
Quando usarlo: Capita soprattutto con il riuso delle connessioni HTTP/2, quando una connessione è condivisa tra nomi host per cui il server non è configurato. Il client dovrebbe riprovare su una nuova connessione.
Definito in RFC 9110 §15.5.20
422
Unprocessable Content
Noto anche come: Unprocessable Entity
Il server capisce il tipo di contenuto e la sintassi è corretta, ma non può elaborare ciò che la richiesta contiene. Prima si chiamava Unprocessable Entity.
Quando usarlo: La risposta abituale a un errore di validazione in una richiesta ben formata. Fa parte di HTTP stesso dalla RFC 9110, non solo di WebDAV.
Definito in RFC 9110 §15.5.21
423
Locked
La risorsa WebDAV a cui si sta accedendo è bloccata.
Quando usarlo: Un file che un altro utente ha bloccato per modificarlo.
Definito in RFC 4918
424
Failed Dependency
La richiesta è fallita perché un'altra azione da cui dipendeva è fallita.
Quando usarlo: In un'operazione WebDAV in blocco, le operazioni che non sono potute partire perché una precedente nella stessa richiesta è fallita.
Definito in RFC 4918
425
Too Early
Il server non vuole rischiare di elaborare una richiesta che potrebbe essere ripetuta.
Quando usarlo: Per le richieste inviate come early data di TLS 1.3 (0-RTT), che un attaccante potrebbe ripetere. Il client dovrebbe riprovare una volta completato l'handshake.
Definito in RFC 8470
426
Upgrade Required
Il server rifiuta la richiesta con il protocollo attuale, ma la accetterebbe dopo che il client è passato a un altro.
Quando usarlo: Inviato con un'intestazione Upgrade che indica il protocollo richiesto, per esempio una versione più recente di HTTP o di TLS.
Definito in RFC 9110 §15.5.22
428
Precondition Required
Il server richiede che la richiesta sia condizionale, con un'intestazione come If-Match.
Quando usarlo: Obbliga i client a dimostrare quale versione stanno modificando, così due modifiche non possono sovrascriversi senza che nessuno se ne accorga.
Definito in RFC 6585
429
Too Many Requests
Il client ha inviato troppe richieste in un certo intervallo di tempo.
Quando usarlo: Limitazione della frequenza (rate limiting). Un'intestazione Retry-After dice quanto aspettare; i client dovrebbero rallentare invece di riprovare subito.
Definito in RFC 6585
431
Request Header Fields Too Large
Il server non elabora la richiesta perché le sue intestazioni, o una singola intestazione, sono troppo grandi.
Quando usarlo: Il più delle volte un cookie troppo grande, o troppi cookie per un solo dominio. Cancellare i cookie del sito di solito risolve.
Definito in RFC 6585
451
Unavailable For Legal Reasons
Il server rifiuta l'accesso alla risorsa a causa di una richiesta legale.
Quando usarlo: Contenuti bloccati da un ordine del tribunale, da una richiesta del governo o da una rimozione in un paese. Il numero è un omaggio al romanzo Fahrenheit 451.
Definito in RFC 7725
5xx · Errore del server
500
Internal Server Error
Il server ha incontrato una condizione imprevista che gli ha impedito di soddisfare la richiesta.
Quando usarlo: Il codice generico per un crash o un'eccezione non gestita. Sono i log del server a dire cosa è successo davvero; di solito il client non può farci nulla.
Definito in RFC 9110 §15.6.1
501
Not Implemented
Il server non supporta la funzionalità necessaria per soddisfare la richiesta.
Quando usarlo: Un metodo che il server non riconosce affatto. A differenza di 405, significa che nessuna risorsa su questo server lo supporta.
Definito in RFC 9110 §15.6.2
502
Bad Gateway
Un server che fa da gateway o proxy ha ricevuto una risposta non valida, o nessuna risposta, dal server che ha dietro.
Quando usarlo: L'applicazione dietro nginx, un load balancer o una CDN si è bloccata, si sta riavviando o non è raggiungibile.
Definito in RFC 9110 §15.6.3
503
Service Unavailable
Il server non può gestire la richiesta in questo momento, perché è sovraccarico o fermo per manutenzione.
Quando usarlo: Una condizione temporanea. Invia un'intestazione Retry-After che dice quando tornare; i motori di ricerca trattano un 503 come temporaneo e mantengono la pagina.
Definito in RFC 9110 §15.6.4
504
Gateway Timeout
Un server che fa da gateway o proxy non ha ricevuto in tempo una risposta dal server che ha dietro.
Quando usarlo: Una query lenta sul database, o un backend che impiega a rispondere più del timeout del proxy.
Definito in RFC 9110 §15.6.5
505
HTTP Version Not Supported
Il server non supporta la versione principale di HTTP usata nella richiesta.
Quando usarlo: Raro, dato che quasi ogni server parla HTTP/1.1, HTTP/2 e spesso HTTP/3.
Definito in RFC 9110 §15.6.6
506
Variant Also Negotiates
Un errore di configurazione del server nella negoziazione trasparente dei contenuti: la variante scelta è a sua volta impostata per negoziare, il che creerebbe un ciclo.
Quando usarlo: Viene dalla negoziazione dei contenuti sperimentale (RFC 2295) e non si vede quasi mai.
Definito in RFC 2295
507
Insufficient Storage
Il server non può memorizzare ciò che la richiesta gli chiede di memorizzare.
Quando usarlo: Un upload o una copia WebDAV quando il disco o la quota dell'utente sono pieni.
Definito in RFC 4918
508
Loop Detected
Il server ha interrotto un'operazione WebDAV perché ha trovato un ciclo infinito.
Quando usarlo: Una richiesta con Depth: infinity attraverso binding che puntano l'uno all'altro.
Definito in RFC 5842
510
Not Extended
Non in usoLa richiesta ha bisogno di ulteriori estensioni che il server esige prima di soddisfarla.
Quando usarlo: Viene dall'HTTP Extension Framework (RFC 2774), poi passato allo stato storico, e il registro segna il codice come obsoleto. Non inviarlo.
Definito in RFC 2774
511
Network Authentication Required
Il client deve autenticarsi per ottenere l'accesso alla rete stessa.
Quando usarlo: Inviato dai captive portal, come le pagine di accesso al Wi-Fi di hotel o aeroporti, che intercettano il traffico finché l'utente non accede.
Definito in RFC 6585