Cos'e' Ricerca Codici di Stato HTTP?
I codici di stato HTTP sono i numeri a tre cifre che un server web restituisce con ogni risposta, comunicando al client (browser, app o consumatore di API) se la richiesta è andata a buon fine, richiede un reindirizzamento, o è fallita — e perché. Sono standardizzati dall'IETF e usati in modo identico in ogni server web, browser e linguaggio di programmazione, il che li rende uno dei riferimenti di debug più universali nello sviluppo software.
Questo strumento di ricerca copre i codici più comunemente incontrati in tutte e cinque le categorie — informativo (1xx), successo (2xx), reindirizzamento (3xx), errore client (4xx) ed errore server (5xx) — con spiegazioni in linguaggio semplice di cosa significa realmente ciascuno nella pratica, non solo la definizione formale dell'RFC.
Quando Usare Questo Calcolatore
- Fare debug di un'integrazione API in cui una richiesta sta fallendo e hai bisogno di capire cosa significa realmente il codice di stato
- Decidere quale codice di stato restituire dalla tua API per una determinata condizione di errore
- Insegnare o imparare i fondamenti HTTP in un corso di sviluppo web o bootcamp
- Scrivere middleware di gestione errori che deve distinguere tra diversi casi 4xx e 5xx
- Indagare sul perché un reindirizzamento non funziona controllando se è stato restituito un 301 o 302
- Risolvere problemi CORS in cui il browser mostra un errore di rete ma il server ha restituito 200
Passaggi:
- Digita un codice di stato (come 404) o una parola chiave (come "forbidden") nella casella di ricerca.
- Filtra per categoria usando i pulsanti 1xx-5xx se vuoi esplorare un intervallo specifico.
- Leggi la descrizione in linguaggio semplice di cosa significa il codice e quando viene tipicamente restituito.
- Usalo come riferimento rapido mentre fai debug delle risposte API o costruisci la gestione degli errori.
Formula
1xx: Informativo — richiesta ricevuta, elaborazione in corso
2xx: Successo — richiesta ricevuta e accettata con successo
3xx: Reindirizzamento — è necessaria un'ulteriore azione per completare la richiesta
4xx: Errore Client — la richiesta contiene sintassi errata o non può essere soddisfatta
5xx: Errore Server — il server non è riuscito a soddisfare una richiesta valida
Casi d'Uso
- Capire rapidamente un codice di stato non familiare restituito da un'API con cui ti stai integrando
- Decidere quale codice di stato restituire dalla tua API per una determinata condizione di errore
- Fare debug del motivo per cui una richiesta fallisce controllando cosa implica realmente un codice specifico
- Insegnare o imparare i fondamenti HTTP in un corso di sviluppo web
- Scrivere una logica di gestione degli errori accurata che distingua tra diversi casi 4xx e 5xx
Vantaggi Principali
- Ogni codice di stato comunemente usato in un unico riferimento consultabile
- Spiegazioni in linguaggio semplice, non solo la formulazione formale dell'RFC
- Filtra istantaneamente per categoria (da 1xx a 5xx)
- Gratuito, veloce, senza bisogno di registrazione
Consigli Pro
- Riserva rigorosamente i codici 5xx ai fallimenti lato server — non usarli mai per segnalare errori di input del client
- Usa 429 con un header Retry-After quando limiti la frequenza, così i client ben progettati sanno quando riprovare
- Preferisci 404 a una pagina di errore generica ogni volta che una risorsa non esiste realmente — è meglio sia per gli utenti che per i motori di ricerca
- Quando progetti un'API, scegli codici 4xx specifici (422, 409, 400) invece di ricadere sempre su un generico 400
Errori Comuni da Evitare
- Restituire 200 OK per una richiesta che in realtà è fallita, nascondendo errori agli strumenti di monitoraggio
- Confondere 401 (non autenticato) con 403 (autenticato ma non autorizzato)
- Usare 302 per un reindirizzamento che dovrebbe essere permanente (301), danneggiando la SEO
- Trattare tutti gli errori 4xx e 5xx allo stesso modo nella gestione degli errori lato client invece di ramificare in base al codice specifico
Termini Chiave Spiegati
- Status line: la prima riga di una risposta HTTP, contenente il codice di stato e una breve frase esplicativa
- Idempotente: una proprietà di certi metodi HTTP per cui ripetere la stessa richiesta ha lo stesso effetto di farla una sola volta
- Catena di reindirizzamenti: una sequenza di più reindirizzamenti che un browser segue prima di raggiungere la risorsa finale
- Rate limiting: limitare quante richieste un client può fare in una determinata finestra di tempo, spesso segnalato con 429
Concetti correlati
- Formattatore JSON:
- Validatore JSON:
- Testatore regex:
- Codificatore/decodificatore URL:
- Codificatore/decodificatore Base64:
Esempio
Cercando "429" si ottiene "Too Many Requests" — il codice che le API restituiscono quando hai superato un limite di frequenza, dicendoti di rallentare e riprovare dopo un ritardo.
Interpretazione dei risultati
I codici di stato HTTP sono raggruppati in cinque classi in base alla prima cifra. I 1xx sono informativi e raramente compaiono nel codice applicativo. I 2xx confermano il successo — 200 OK è il più comune, ma anche 201 Created e 204 No Content sono frequenti nelle API REST. I 3xx gestiscono i reindirizzamenti, con 301 (permanente) e 302 (temporario) come i più importanti.
Gli errori 4xx indicano un problema con la richiesta del client. I più comuni sono 400 Bad Request (sintassi non valida), 401 Unauthorized (non autenticato), 403 Forbidden (non autorizzato), 404 Not Found (risorsa inesistente) e 429 Too Many Requests (limite di frequenza superato). L'uso corretto di codici 4xx specifici rende la tua API molto più facile da debuggare che restituire un 400 generico per tutto.
Gli errori 5xx significano che il server è fallito. 500 è l'errore interno generico, 502 Bad Gateway indica un problema con un server a monte, e 503 Service Unavailable di solito significa che il server è sovraccarico o in manutenzione. Quando fai debug degli errori 5xx, controlla i log del server invece della risposta del client, poiché il solo codice di stato raramente rivela la causa principale.