Vai al contenuto
helpyself

Codici di stato HTTP

Solo in locale — non viene caricato niente a meno che tu non lo salvi o lo condivida.

Tutti i codici di stato HTTP, cosa significano e quando inviarli — con la RFC che li definisce.

  1. Scrivi il codice, per esempio 404, o una parola come «reindirizzamento» nel campo di ricerca.
  2. Leggi cosa significa il codice, quando inviarlo e quale RFC lo definisce.
  3. Scegli una classe come 4xx, oppure svuota il campo per vedere tutti i codici raggruppati per classe.

4xx · Errore del client

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

Salva questo strumento

Tieni Codici di stato HTTP a portata di mano

Aggiungi ai preferiti
Incorpora

Metti Codici di stato HTTP sul tuo sito

Incolla questo codice nella tua pagina. Mostra lo strumento, gratis, con un link allo strumento.

Su questo strumento

Tutti i codici di stato HTTP del registro ufficiale IANA, da 100 Continue a 511 Network Authentication Required, ciascuno con una spiegazione chiara di cosa significa, di quando un server dovrebbe inviarlo e un link alla sezione della RFC che lo definisce. Scrivi un numero, la prima cifra di una classe («4» o «4xx») o una parola come «reindirizzamento» o «limite», e l'elenco si restringe mentre scrivi. Le differenze che contano sono spiegate invece di essere lasciate al solo nome. 401 Unauthorized significa che la richiesta non era autenticata — accedi e riprova — mentre 403 Forbidden significa che il server ha capito la richiesta e dice comunque di no. 301 e 302 permettono a un client vecchio di trasformare un POST in un GET mentre segue il nuovo indirizzo; 308 e 307 sono gli stessi due reindirizzamenti, con la garanzia che il metodo resti lo stesso. 422 Unprocessable Content non è più un'aggiunta di WebDAV: la RFC 9110 lo ha reso parte di HTTP nel 2022, ed è per questo che è la risposta abituale a un errore di validazione. I nomi restano esattamente come li scrive la specifica, perché è ciò che compare sulla riga di stato, nei tuoi log e in ogni libreria. Quando un codice è stato rinominato — 413 si chiamava Payload Too Large, 422 Unprocessable Entity — viene mostrato anche il vecchio nome, e la ricerca lo trova. C'è anche 418 I'm a teapot, presentato per quello che è: uno scherzo del primo aprile della RFC 2324 che la RFC 9110 ora riserva, così nessuno può dare a quel numero un ruolo vero. I codici non ufficiali, come il 499 di nginx o i 520–526 di Cloudflare, non sono nel registro e non vengono elencati come se ci fossero. Tutto funziona nel tuo browser, anche offline una volta caricata la pagina.

Domande frequenti

Qual è la differenza tra 401 e 403?

401 Unauthorized significa che la richiesta non ha credenziali valide: il server non sa chi sei, e deve indicare come autenticarsi in un'intestazione WWW-Authenticate. Accedere può risolvere. 403 Forbidden significa che il server ha capito la richiesta e la rifiuta comunque: ripeterla con le stesse credenziali non serve, servirebbe solo un account con il permesso giusto. Nonostante il nome, 401 riguarda l'autenticazione e 403 i permessi.

Per un reindirizzamento permanente meglio 301 o 308?

Per una pagina web vanno bene entrambi, e 301 è quello che ogni crawler e browser gestisce da decenni; i motori di ricerca li trattano allo stesso modo. La differenza è il metodo. Con 301 un client vecchio può trasformare un POST in un GET quando segue il reindirizzamento, mentre 308 garantisce che metodo e corpo restino esattamente com'erano. Per un endpoint di API che accetta POST o PUT, usa 308. La coppia temporanea funziona allo stesso modo: 302 può cambiare il metodo, 307 non deve.

Cosa significa 304 Not Modified?

Risponde a una richiesta condizionale — inviata con If-None-Match o If-Modified-Since — e dice che la copia che il client ha già è ancora aggiornata, quindi non viene inviato alcun corpo. È così che la cache risparmia banda, e non è un errore: tanti 304 nei log vogliono dire che la cache funziona.

Per un errore di validazione è giusto 422 o 400?

Usa 400 quando la richiesta non si può leggere affatto — JSON rotto, un'intestazione obbligatoria mancante. Usa 422 Unprocessable Content quando è ben formata ma il suo contenuto non può essere elaborato, per esempio un campo email che non contiene un indirizzo email. 422 è nato in WebDAV ed è stato portato dentro HTTP dalla RFC 9110 nel 2022, quindi non è più un'estensione.

Qual è la differenza tra 502, 503 e 504?

Tutti e tre di solito arrivano da un proxy o da un load balancer, non dalla tua applicazione. 502 Bad Gateway significa che il server dietro ha inviato una risposta non valida o nessuna risposta, spesso perché si è bloccato. 503 Service Unavailable significa che il server è attivo ma in questo momento non può accettare la richiesta — sovraccarico o in manutenzione — idealmente con un'intestazione Retry-After. 504 Gateway Timeout significa che il server dietro il proxy ha impiegato troppo a rispondere.

418 I'm a teapot è un vero codice di stato?

È nato come scherzo: la RFC 2324, una RFC del primo aprile del 1998, lo definiva per le caffettiere a cui si chiede un caffè ma che sono teiere. Non doveva mai essere implementato, ma così tanti framework lo hanno aggiunto che la RFC 9110 ora segna 418 come riservato, perché a quel numero non si possa dare un significato reale. Usarlo in produzione è uno scherzo che i client della tua API devono capire.

Perché mancano 499, 509 e 520?

Non sono codici di stato HTTP registrati. 499 viene registrato da nginx quando il client ha chiuso la connessione prima della risposta, 509 Bandwidth Limit Exceeded arriva da alcuni hosting, e 520–526 sono errori propri di Cloudflare per i problemi nel raggiungere il server di origine. Ognuno ha senso solo per quel prodotto, quindi l'elenco si attiene al registro ufficiale.

Aiutaci a migliorare questo strumento

Hai trovato un errore, vuoi una modifica, o ti manca uno strumento?

/http-status-codes

↑↓ per muoverti · Invio per aprire · Esc per chiudere