Sviluppatore

Codici di stato HTTP

Cerca un codice HTTP: significato e quando usarlo.

  • Istantaneo
  • Gratis
  • Privato (elaborato localmente)
  • Senza registrazione
200OK
Successo

La richiesta è riuscita.

201Created
Successo

Risorsa creata con successo.

202Accepted
Successo

Accettata, in elaborazione.

204No Content
Successo

Successo, nessun contenuto.

206Partial Content
Successo

Contenuto parziale (range).

301Moved Permanently
Redirezione

Spostato permanentemente a nuova URL.

302Found
Redirezione

Redirezione temporanea.

304Not Modified
Redirezione

Non modificato, usa la cache.

307Temporary Redirect
Redirezione

Redirezione temporanea, metodo mantenuto.

308Permanent Redirect
Redirezione

Redirezione permanente, metodo mantenuto.

400Bad Request
Errore client

Richiesta malformata dal client.

401Unauthorized
Errore client

Autenticazione richiesta o fallita.

403Forbidden
Errore client

Accesso vietato, diritti insufficienti.

404Not Found
Errore client

Risorsa non trovata.

405Method Not Allowed
Errore client

Metodo HTTP non consentito qui.

409Conflict
Errore client

Conflitto con lo stato attuale.

410Gone
Errore client

Risorsa rimossa definitivamente.

418I'm a teapot
Errore client

Sono una teiera (scherzo d’aprile).

422Unprocessable Entity
Errore client

Sintassi valida ma non elaborabile.

429Too Many Requests
Errore client

Troppe richieste, rallenta.

500Internal Server Error
Errore server

Errore interno del server.

501Not Implemented
Errore server

Funzionalità non implementata.

502Bad Gateway
Errore server

Risposta non valida dall’upstream.

503Service Unavailable
Errore server

Servizio non disponibile (sovraccarico, manutenzione).

504Gateway Timeout
Errore server

Timeout da un server upstream.

Il dizionario dei codici HTTP, a una ricerca di distanza

Quando una richiesta web fallisce, il server restituisce un codice a tre cifre. Questo strumento li raccoglie e li spiega: digita un numero (404) o una frase («not found»), filtra per classe e leggi il significato e l’uso corretto di ogni codice.

  1. Cerca

    Per numero, per frase o per classe («4» per i 4xx).

  2. Leggi la scheda

    Codice, frase ufficiale, categoria e descrizione.

  3. Scegli il codice giusto

    Per la tua API, il redirect o la pagina di errore.

Le quattro grandi famiglie

ClasseSensoEsempi
2xxSuccesso200 OK, 201 Created, 204 No Content
3xxRedirezione301 Moved, 302 Found, 304 Not Modified
4xxErrore client400, 401, 403, 404, 429
5xxErrore server500, 502, 503, 504

Riflesso di debug: la prima cifra indica il lato. Un 4xx si corregge nella richiesta (URL, diritti, formato); un 5xx sul server (codice, configurazione, sovraccarico).

Domande frequenti

Cosa significano le classi 2xx, 3xx, 4xx, 5xx?

La prima cifra dà la categoria: 2xx = successo, 3xx = redirezione, 4xx = errore client (la tua richiesta), 5xx = errore server. Un’occhiata alla prima cifra dice già di chi è il problema.

Qual è la differenza tra 401 e 403?

401 (Unauthorized) significa «identificati»: l’autenticazione manca o è fallita. 403 (Forbidden) significa «so chi sei, ma non hai il permesso». Il primo si risolve facendo login, il secondo no.

Quando usare 301 invece di 302?

301 (Moved Permanently) per uno spostamento definitivo: i motori di ricerca trasferiscono il ranking al nuovo URL. 302 (Found) per uno spostamento temporaneo: il vecchio URL resta il riferimento. Sbagliare danneggia la SEO.

Il codice 418 esiste davvero?

Sì! 418 «I’m a teapot» nasce da un pesce d’aprile del 1998 (protocollo per caffettiere). Non ha uso serio ma è diventato uno scherzo di culto, e alcuni server lo restituiscono per richieste assurde.