I status code sono un linguaggio
Impara a leggere quello che il server dice con i codici di risposta
⏱ Stima ~5 min
01 · Leggi
Ogni risposta HTTP inizia con un status code (codice di stato). È la prima parola del server — prima ancora che tu legga il corpo.
I codici sono raggruppati in base alla prima cifra: - 2xx = Successo (tutto ok) - 4xx = Errore del client (hai sbagliato tu) - 5xx = Errore del server (hanno sbagliato loro)
Sapendo questo, puoi diagnosticare qualsiasi problema API in pochi secondi.
Punti chiave
- 200 = OK — richiesta riuscita, il corpo contiene i dati
- 401 = Unauthorized — devi autenticarti
- 403 = Forbidden — autenticato ma senza i permessi
- 404 = Not Found — quel percorso non esiste
- 429 = Too Many Requests — sei stato limitato dal rate limiting
- 500 = Internal Server Error — bug loro, non tuo
02 · Pratica nel terminale
Proviamo a provocare degli errori di proposito per vedere le risposte. Usa -i per vedere la riga di stato. Prima richiedi un path che non esiste.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
03 · Pratica nel terminale
Ora proviamo a scatenare un 401 — un endpoint protetto che richiede autenticazione.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
04 · Pratica nel terminale
Ora il 500 — questo è un problema del server, non tuo.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
05 · Abbina
Abbina ogni status code HTTP al suo significato.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
06 · Quiz
Chiami un'API e ricevi HTTP/2 429. Cosa dovresti fare?
- Correggi il tuo codice — hai mandato una richiesta malformata
- Controlla la tua API key — probabilmente è scaduta
- Aspetta un po' e riprova — hai superato il rate limit
- Il server è giù — prova un altro endpoint
Altre lezioni di questo capitolo
⚠ L'esperienza interattiva completa richiede JavaScript. Attivalo e ricarica la pagina.
※ Questo è un progetto educativo indipendente — non è un prodotto ufficiale di Anthropic. Claude™ è un marchio di Anthropic, PBC.