Guida pratica

Codici di Stato HTTP — Guida all’uso e principi tecnici

Riferimento interattivo ai codici di stato HTTP 1xx-5xx con descrizioni, scenari d'uso, best practice REST e strumenti di verifica.

Apri lo strumento

Panoramica

I codici di stato HTTP comunicano al client l'esito della richiesta, guidando retry, messaggi all'utente e automazioni. Una corretta attribuzione migliora l'osservabilità, consente SLO precisi e rende le API prevedibili per consumatori web e mobile.

Concetti chiave

Struttura delle classi

I codici sono a tre cifre: la prima identifica la classe (1-5), le restanti due definiscono lo stato. Gli standard più recenti (RFC 9110) aggiungono codici come 421 Misdirected Request e 425 Too Early.

Negoziazione client-server

Il codice guida il comportamento del client: retry controllato per 503 Retry-After, aggiornamento URI per 308 Permanent Redirect, autenticazione per 401/407, fix del payload per 422 Unprocessable Content.

Best practice REST

API REST mature mappano operazioni CRUD su 200/201/204. Errori di validazione usano 400 o 422, conflitti di versione 409, rate limit 429 con header Retry-After e link alla documentazione.

Osservabilità e SLO

La percentuale di 5xx è un indicatore SRE critico. I codici devono essere loggati con correlation ID per facilitare il tracing distribuito e la root cause analysis.

Funzionalità principali

Catalogo normativo completo

Include tutti i codici standardizzati da RFC 7231/6585/9110 con descrizioni sintetiche, estese e note di implementazione REST.

Ricerca semantica e filtri

Trova rapidamente codici per numero, parola chiave o scenario; filtra per classe o per API (REST, GraphQL, gRPC gateway).

Snippet pronti all'uso

Copia esempi curl, fetch e Axios per testare risposte con codici specifici e simulare scenari di fallback.

Linee guida error handling

Ogni codice include best practice su log, retry, deduplicazione alert e mapping verso eccezioni applicative.

Domande frequenti

Qual è la differenza tra 301 e 302?

301 indica spostamento permanente e il client dovrebbe aggiornare il link. 302 è temporaneo: la risorsa originale resta valida. Per form POST è preferibile 307/308 che preservano il metodo.

Quando usare 422 invece di 400?

422 Unprocessable Content segnala payload sintatticamente valido ma semanticamente errato (es. campi fuori range). 400 indica errore generico di sintassi o parametri mancanti.

Come segnalare rate limiting?

Utilizza 429 Too Many Requests con header Retry-After e X-RateLimit-Remaining per indicare la finestra di riprova al client.

Perché 5xx è così critico?

I codici 5xx denotano problemi sul server che impattano la disponibilità. Dovrebbero generare alert e includere correlation ID per facilitare il debugging.

Riferimenti autorevoli

Codici di Stato HTTP

Apri lo strumento per provare queste funzionalità.

Apri lo strumento