I codici di stato della risposta HTTP indicano se una specifica richiesta HTTP è stata completata correttamente.

I codici di stato della risposta HTTP indicano se una specifica richiesta HTTP è stata completata correttamente. Le risposte sono raggruppate in cinque classi:

1. Risposte informative ( 100 – 199 ),
2. Risposte di successo ( 200 – 299 ),
3. Reindirizzamenti ( 399 ),
4. Errori client ( 400 – 499 ),
5. e errori del server ( 500 – 599 ).

I seguenti codici di stato sono definiti dalla sezione 10 di RFC 2616 . È possibile trovare una specifica aggiornata in RFC 7231 .

Risposte informative

100 Continue

Questa risposta intermedia indica che finora tutto è OK e che il client deve continuare la richiesta o ignorare la risposta se la richiesta è già terminata.

101 Switching Protocol

Questo codice viene inviato in risposta a un’intestazione della richiesta di Upgrade dal client e indica il protocollo a cui sta passando il server.

102 Processing ( WebDAV )

Questo codice indica che il server ha ricevuto e sta elaborando la richiesta, ma non è ancora disponibile alcuna risposta.

103 Early Hints

Questo codice di stato deve essere utilizzato principalmente con l’intestazione Link , consentendo all’agente utente di precaricare le risorse mentre il server prepara una risposta.

Risposte di successo

200 OK

La richiesta è riuscita. Il significato del successo dipende dal metodo HTTP:

• GET : la risorsa è stata recuperata e viene trasmessa nel corpo del messaggio.
• HEAD : le intestazioni delle entità si trovano nel corpo del messaggio.
• PUT o POST : la risorsa che descrive il risultato dell’azione viene trasmessa nel corpo del messaggio.
• TRACE : il corpo del messaggio contiene il messaggio di richiesta ricevuto dal server

201 Created

La richiesta ha avuto esito positivo e di conseguenza è stata creata una nuova risorsa. Questa è in genere la risposta inviata dopo POST richieste POST o alcune richieste PUT .

202 Accepted

La richiesta è stata ricevuta ma non ancora accettata. Non è impegnativo, poiché in HTTP non è possibile inviare in seguito una risposta asincrona che indica l’esito della richiesta. È destinato ai casi in cui un altro processo o server gestisce la richiesta o per l’elaborazione in batch.

203 Non-Authoritative Information

Questo codice di risposta indica che le meta-informazioni restituite non sono esattamente le stesse disponibili nel server di origine, ma sono raccolte da una copia locale o di terze parti. Viene utilizzato principalmente per mirror o backup di un’altra risorsa. Tranne che per quel caso specifico, la risposta “200 OK” è preferita a questo stato.

204 No Content

Non ci sono contenuti da inviare per questa richiesta, ma le intestazioni potrebbero essere utili. L’utente-agente può aggiornare le sue intestazioni memorizzate nella cache per questa risorsa con quelle nuove.

205 Reset Content

Indica all’utente-agente di ripristinare il documento che ha inviato questa richiesta.

206 Partial Content

Questo codice di risposta viene utilizzato quando l’intestazione Range viene inviata dal client per richiedere solo una parte di una risorsa.

207 Multi-Status ( WebDAV )

Fornisce informazioni su più risorse, per situazioni in cui più codici di stato potrebbero essere appropriati.

208 Already Reported ( WebDAV )

Utilizzato all’interno di un elemento di risposta <dav:propstat> per evitare di enumerare ripetutamente i membri interni di più bind nella stessa raccolta.

226 IM Used ( codifica HTTP Delta )

Il server ha soddisfatto una richiesta GET per la risorsa e la risposta è una rappresentazione del risultato di una o più manipolazioni dell’istanza applicate all’istanza corrente.

Messaggi di reindirizzamento

300 Multiple Choice

La richiesta ha più di una possibile risposta. L’utente-agente o l’utente dovrebbe sceglierne uno. (Non esiste un modo standardizzato di scegliere una delle risposte, ma si consigliano collegamenti HTML alle possibilità in modo che l’utente possa scegliere.)

301 Moved Permanently

L’URL della risorsa richiesta è stato modificato in modo permanente. Il nuovo URL è indicato nella risposta.

302 Found

Questo codice di risposta indica che l’URI della risorsa richiesta è stato temporaneamente modificato. Ulteriori modifiche all’URI potrebbero essere apportate in futuro. Pertanto, questo stesso URI dovrebbe essere utilizzato dal client nelle richieste future.

303 See Other

Il server ha inviato questa risposta per indirizzare il client a ottenere la risorsa richiesta in un altro URI con una richiesta GET.

304 Not Modified

Questo è usato per scopi di memorizzazione nella cache. Indica al client che la risposta non è stata modificata, quindi il client può continuare a utilizzare la stessa versione cache della risposta.

305 Use Proxy 

Definito in una versione precedente della specifica HTTP per indicare che un proxy deve accedere a una risposta richiesta. È stato deprecato a causa di problemi di sicurezza relativi alla configurazione in-band di un proxy.

306 unused

Questo codice di risposta non è più utilizzato; è solo riservato. Era utilizzato in una versione precedente della specifica HTTP / 1.1.

307 Temporary Redirect

Il server invia questa risposta per indirizzare il client a ottenere la risorsa richiesta in un altro URI con lo stesso metodo utilizzato nella richiesta precedente. Questo ha la stessa semantica del codice di risposta HTTP 302 Found , con l’eccezione che l’agente utente non deve modificare il metodo HTTP utilizzato: se nella prima richiesta è stato utilizzato un POST nella seconda richiesta deve essere utilizzato un POST .

308 Permanent Redirect

Ciò significa che la risorsa si trova ora in modo permanente in un altro URI, specificato dall’intestazione Location: HTTP Response. Questo ha la stessa semantica del codice di risposta HTTP 301 Moved Permanently , con l’eccezione che l’agente utente non deve modificare il metodo HTTP utilizzato: se nella prima richiesta è stato utilizzato un POST necessario utilizzare un POST nella seconda richiesta.

Risposte agli errori del client

400 Bad Request

Il server non è stato in grado di comprendere la richiesta a causa di una sintassi non valida.

401 Unauthorized

Sebbene lo standard HTTP specifichi “non autorizzato”, semanticamente questa risposta significa “non autenticato”. Cioè, il client deve autenticarsi per ottenere la risposta richiesta.

402 Payment Required 

Questo codice di risposta è riservato per uso futuro. L’obiettivo iniziale per la creazione di questo codice era usarlo per i sistemi di pagamento digitali, tuttavia questo codice di stato viene utilizzato molto raramente e non esiste alcuna convenzione standard.

403 Forbidden

Il cliente non ha diritti di accesso al contenuto; cioè, non è autorizzato, quindi il server si rifiuta di fornire la risorsa richiesta. A differenza di 401, l’identità del client è nota al server.

404 Not Found

Il server non riesce a trovare la risorsa richiesta. Nel browser, ciò significa che l’URL non è riconosciuto. In un’API, ciò può anche significare che l’endpoint è valido ma la risorsa stessa non esiste. I server possono anche inviare questa risposta invece di 403 per nascondere l’esistenza di una risorsa da un client non autorizzato. Questo codice di risposta è probabilmente il più famoso a causa della sua frequente presenza sul web.

405 Method Not Allowed

Il metodo di richiesta è noto al server ma è stato disabilitato e non può essere utilizzato. Ad esempio, un’API potrebbe vietare ELIMINARE una risorsa. I due metodi obbligatori, GET e HEAD , non devono mai essere disabilitati e non devono restituire questo codice di errore.

406 Not Acceptable

Questa risposta viene inviata quando il server Web, dopo aver eseguito la negoziazione del contenuto guidata dal server , non trova alcun contenuto conforme ai criteri forniti dall’agente utente.

407 Proxy Authentication Required

È simile a 401 ma l’autenticazione deve essere eseguita da un proxy.

408 Request Timeout

Questa risposta viene inviata su una connessione inattiva da alcuni server, anche senza alcuna richiesta precedente da parte del client. Significa che il server vorrebbe chiudere questa connessione inutilizzata. Questa risposta viene utilizzata molto di più poiché alcuni browser, come Chrome, Firefox 27+ o IE9, utilizzano meccanismi di pre-connessione HTTP per velocizzare la navigazione. Si noti inoltre che alcuni server hanno semplicemente chiuso la connessione senza inviare questo messaggio.

409 Conflict

Questa risposta viene inviata quando una richiesta è in conflitto con lo stato corrente del server.

410 Gone

Questa risposta viene inviata quando il contenuto richiesto è stato eliminato definitivamente dal server, senza indirizzo di inoltro. I clienti devono rimuovere le loro cache e i collegamenti alla risorsa. La specifica HTTP intende utilizzare questo codice di stato per “servizi promozionali a tempo limitato”. Le API non devono sentirsi obbligate a indicare risorse che sono state eliminate con questo codice di stato.

411 Length Required

Il server ha rifiutato la richiesta perché il campo di intestazione Content-Length non è definito e il server lo richiede.

412 Precondition Failed

Nelle sue intestazioni il client ha indicato i presupposti che il server non soddisfa.

413 Payload Too Large

L’entità richiesta è superiore ai limiti definiti dal server; il server potrebbe chiudere la connessione o restituire un campo di intestazione Retry-After .

414 URI Too Long

L’URI richiesto dal client è più lungo di quanto il server sia disposto a interpretare.

415 Unsupported Media Type

Il formato multimediale dei dati richiesti non è supportato dal server, quindi il server sta rifiutando la richiesta.

416 Range Not Satisfiable

L’intervallo specificato dal Range intestazione Range nella richiesta non può essere soddisfatto; è possibile che l’intervallo sia esterno alla dimensione dei dati dell’URI di destinazione.

417 Expectation Failed

Questo codice di risposta indica che il server non può soddisfare le aspettative indicate dal campo di intestazione Richiesta attesa.

418 I'm a teapot

Il server rifiuta il tentativo di preparare il caffè con una teiera.

421 Misdirected Request

La richiesta è stata indirizzata a un server che non è in grado di produrre una risposta. Questo può essere inviato da un server non configurato per produrre risposte per la combinazione di schema e autorità inclusi nell’URI della richiesta.

422 Unprocessable Entity ( WebDAV )

La richiesta era ben formata ma non poteva essere seguita a causa di errori semantici.

423 Locked ( WebDAV )

La risorsa a cui si accede è bloccata.

424 Failed Dependency ( WebDAV )

La richiesta non è riuscita a causa del fallimento di una richiesta precedente.

425 Too Early

Indica che il server non è disposto a rischiare di elaborare una richiesta che potrebbe essere riprodotta.

426 Upgrade Required

Il server rifiuta di eseguire la richiesta utilizzando il protocollo corrente ma potrebbe essere disposto a farlo dopo che il client ha eseguito l’aggiornamento a un protocollo diverso. Il server invia un’intestazione di Upgrade in una risposta 426 per indicare i protocolli richiesti.

428 Precondition Required

Il server di origine richiede che la richiesta sia condizionale. Questa risposta ha lo scopo di prevenire il problema dell ‘”aggiornamento perso”, in cui un client OTTIENE lo stato di una risorsa, lo modifica e lo restituisce al server, quando nel frattempo una terza parte ha modificato lo stato sul server, causando un conflitto.

429 Too Many Requests

L’utente ha inviato troppe richieste in un determinato periodo di tempo (“limitazione della velocità”).

431 Request Header Fields Too Large

Il server non è disposto a elaborare la richiesta perché i suoi campi di intestazione sono troppo grandi. La richiesta può essere reinviata dopo aver ridotto la dimensione dei campi dell’intestazione della richiesta.

451 Unavailable For Legal Reasons

L’agente utente ha richiesto una risorsa che non può essere legalmente fornita, come una pagina web censurata da un governo.

Risposte agli errori del server

500 Internal Server Error

Il server ha riscontrato una situazione che non sa come gestire.

501 Not Implemented

Il metodo di richiesta non è supportato dal server e non può essere gestito. Gli unici metodi che i server sono tenuti a supportare (e quindi che non devono restituire questo codice) sono GET e HEAD .

502 Bad Gateway

Questa risposta di errore indica che il server, pur lavorando come gateway per ottenere una risposta necessaria per gestire la richiesta, ha ottenuto una risposta non valida.

503 Service Unavailable

Il server non è pronto per gestire la richiesta. Cause comuni sono un server inattivo per manutenzione o sovraccarico. Si noti che insieme a questa risposta, dovrebbe essere inviata una pagina intuitiva che spiega il problema. Queste risposte devono essere utilizzate per condizioni temporanee e l’intestazione Retry-After: HTTP, se possibile, deve contenere il tempo stimato prima del ripristino del servizio. Il webmaster deve anche occuparsi delle intestazioni relative alla memorizzazione nella cache che vengono inviate insieme a questa risposta, poiché queste risposte alle condizioni temporanee di solito non devono essere memorizzate nella cache.

504 Gateway Timeout

Questa risposta di errore viene fornita quando il server funge da gateway e non è in grado di ottenere una risposta in tempo.

505 HTTP Version Not Supported

La versione HTTP utilizzata nella richiesta non è supportata dal server.

506 Variant Also Negotiates

Il server presenta un errore di configurazione interno: la risorsa variante scelta è configurata per impegnarsi nella negoziazione trasparente del contenuto stesso e non è quindi un punto finale appropriato nel processo di negoziazione.

507 Insufficient Storage ( WebDAV )

Non è stato possibile eseguire il metodo sulla risorsa perché il server non è in grado di memorizzare la rappresentazione necessaria per completare correttamente la richiesta.

508 Loop Detected ( WebDAV )

Il server ha rilevato un ciclo infinito durante l’elaborazione della richiesta.

510 Not Extended

Sono necessarie ulteriori estensioni alla richiesta affinché il server la soddisfi.

511 Network Authentication Required

Il codice di stato 511 indica che il client deve autenticarsi per ottenere l’accesso alla rete.

Compatibilità del browser

Guarda anche

• Registro ufficiale IANA dei codici di stato HTTP