Un elenco di codici di stato HTTP veloce e ricercabile
Ogni volta che un browser, un'app mobile o il crawler di un motore di ricerca effettua una richiesta a un server web, il server risponde con un numero a tre cifre. Questi codici di stato HTTP indicano al client esattamente cos'è successo: se la richiesta è andata a buon fine, è fallita, richiede un'autenticazione o deve essere reindirizzata altrove.
Questo strumento fornisce un dizionario completo e ricercabile dei codici di risposta HTTP standard, basato sulle specifiche RFC ufficiali. Poiché l'intero elenco viene caricato e filtrato localmente nel tuo browser, la ricerca è immediata. Non devi aspettare che la pagina si ricarichi per cercare la differenza tra un 301 e un 302, o per capire cosa significa un errore 422.
Le cinque classi dei codici di stato HTTP
I codici HTTP sono raggruppati in cinque classi distinte, definite dalla loro prima cifra. Comprendere queste categorie è il modo più rapido per diagnosticare i problemi di traffico web:
1xx (Informativi)
Questi codici indicano che il server ha ricevuto la richiesta e sta continuando il processo. Sono risposte temporanee e il client deve attendere una risposta finale. Ad esempio, 100 Continue indica al client di procedere e inviare il corpo della richiesta.
2xx (Successo)
Un codice 2xx significa che la richiesta del client è stata ricevuta, compresa e accettata con successo. Il più comune è 200 OK, la risposta standard per una richiesta HTTP andata a buon fine. Quando si crea un nuovo record tramite API, si potrebbe ricevere un 201 Created.
3xx (Reindirizzamento)
Questi codici indicano al client che sono necessarie ulteriori azioni per completare la richiesta. Di solito significa che la risorsa richiesta è stata spostata. Un 301 Moved Permanently comunica ai motori di ricerca di aggiornare i propri link, mentre un 302 Found indica uno spostamento temporaneo.
4xx (Errore del client)
I codici di errore HTTP della serie 4xx indicano che il problema risiede lato client. La richiesta potrebbe contenere una sintassi errata, non avere un'autenticazione valida o richiedere una risorsa inesistente. Questi errori sono comuni quando gli utenti digitano male gli URL o quando le integrazioni API inviano dati formattati in modo errato.
5xx (Errore del server)
Un codice 5xx significa che il server non è riuscito a soddisfare una richiesta valida. Il client ha fatto tutto correttamente, ma il server ha riscontrato un problema interno, è andato in crash o è attualmente sovraccarico.
Codici di errore HTTP comuni che dovresti conoscere
Sebbene esistano decine di codici, solo alcuni rappresentano la stragrande maggioranza degli errori che incontrerai come sviluppatore o webmaster:
Il codice di stato 404 (Not Found)
Forse l'errore più famoso su internet, il codice di stato 404 significa che il server non è riuscito a trovare la risorsa richiesta. Per i proprietari di siti web, monitorare gli errori 404 è fondamentale per la SEO, poiché i link rotti frustrano gli utenti e sprecano il crawl budget.
400 Bad Request
Il server non può elaborare la richiesta a causa di un errore del client, come una sintassi della richiesta errata o un routing non valido. Le API restituiscono spesso questo errore quando manca un parametro obbligatorio.
401 Unauthorized & 403 Forbidden
Entrambi riguardano l'accesso. Un 401 Unauthorized significa che il client deve autenticarsi per ottenere la risposta richiesta (es. chiave API mancante). Un 403 Forbidden significa che l'identità del client è nota, ma non dispone dei permessi necessari per accedere alla risorsa.
500 Internal Server Error
È un errore generico per i crash lato server. Significa che il server ha riscontrato una condizione imprevista che gli ha impedito di soddisfare la richiesta. Quando vedi un errore 500, di solito devi controllare i log dell'applicazione del server per trovare la causa principale.
502 Bad Gateway & 503 Service Unavailable
Un 502 Bad Gateway si verifica quando un server che funge da proxy (come Nginx o un load balancer) riceve una risposta non valida dal server upstream. Un 503 Service Unavailable significa che il server non è attualmente in grado di gestire la richiesta, in genere perché è sovraccarico o in manutenzione.
Best practice per lo sviluppo di API
Quando si crea un'API REST, restituire i codici di stato HTTP corretti è fondamentale per offrire una buona esperienza agli sviluppatori. Restituire un 200 OK quando si è verificato un errore (pratica nota come "swallowing" o mascheramento degli errori) costringe i client ad analizzare manualmente il corpo della risposta per capire se la richiesta è effettivamente andata a buon fine.
Usa questa guida per scegliere il codice semanticamente più corretto. Ad esempio, usa 429 Too Many Requests quando un utente supera il rate limit, oppure 422 Unprocessable Content quando il payload JSON è valido ma fallisce la validazione della logica di business.
Se stai analizzando problemi di routing del server, potresti trovare utile anche il nostro strumento di DNS Lookup per verificare i record di dominio, oppure il Parser di User-Agent per identificare i client che effettuano richieste al tuo server. Se vuoi gestire la scansione del tuo sito da parte dei motori di ricerca per evitare errori 404, prova il Generatore di Robots.txt.