📊

Codici di Stato HTTP

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

Guida pratica
Cerca
Codici di stato
CodiceNomeRiferimento interattivo ai codici di stato HTTP 1xx-5xx con descrizioni, scenari d'uso, best practice REST e strumenti di verifica.Classe
100ContinuaIl server ha ricevuto le intestazioni della richiesta e il client deve procedere all'invio del corpo della richiesta.Informativo (1xx)
101Cambio di protocolloIl richiedente ha chiesto al server di cambiare protocollo e il server ha accettato di farlo.Informativo (1xx)
102ElaborazioneIl server ha ricevuto ed sta elaborando la richiesta, ma non è ancora disponibile alcuna risposta.Informativo (1xx)
103Suggerimenti anticipatiUsato per restituire alcune intestazioni di risposta prima del messaggio HTTP finale.Informativo (1xx)
200OKLa richiesta ha avuto successo. Le informazioni restituite con la risposta dipendono dal metodo utilizzato nella richiesta.Successo (2xx)
201CreatoLa richiesta è stata soddisfatta e ha portato alla creazione di una nuova risorsa.Successo (2xx)
202AccettatoLa richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è stata completata.Successo (2xx)
203Informazioni non autorevoliIl server ha elaborato con successo la richiesta, ma sta restituendo informazioni che potrebbero provenire da un'altra fonte.Successo (2xx)
204Nessun contenutoIl server ha elaborato con successo la richiesta e non sta restituendo alcun contenuto.Successo (2xx)
205Ripristina contenutoIl server ha elaborato con successo la richiesta, ma non sta restituendo alcun contenuto e richiede che il richiedente ripristini la visualizzazione del documento.Successo (2xx)
206Contenuto parzialeIl server sta fornendo solo parte della risorsa a causa di un'intestazione di intervallo inviata dal client.Successo (2xx)
207Multi-statoIl corpo del messaggio che segue è un messaggio XML e può contenere un numero di codici di risposta separati.Successo (2xx)
208Già segnalatoI membri di un binding DAV sono già stati enumerati in una parte precedente della risposta multistatus.Successo (2xx)
226IM usatoIl server ha soddisfatto una richiesta per la risorsa e la risposta è una rappresentazione del risultato di una o più manipolazioni di istanza applicate all'istanza corrente.Successo (2xx)
300Scelte multipleLa richiesta ha più di una possibile risposta. L'agente utente o l'utente deve sceglierne una.Reindirizzamento (3xx)
301Spostato permanentementeL'URL della risorsa richiesta è stato modificato in modo permanente. Il nuovo URL viene fornito nella risposta.Reindirizzamento (3xx)
302TrovatoL'URI della risorsa richiesta è stato modificato temporaneamente. Ulteriori modifiche all'URI potrebbero essere apportate in futuro.Reindirizzamento (3xx)
303Vedi altroIl server ha inviato questa risposta per indirizzare il client a ottenere la risorsa richiesta a un altro URI con una richiesta GET.Reindirizzamento (3xx)
304Non modificatoQuesto viene utilizzato per scopi di memorizzazione nella cache. Dice al client che la risposta non è stata modificata.Reindirizzamento (3xx)
305Usa proxyLa risorsa richiesta è disponibile solo tramite un proxy, il cui indirizzo è fornito nella risposta.Reindirizzamento (3xx)
  • Mostrando 1-20 di 63 risultati
  • 1
  • 2
  • 3
  • 4
  • Vai alla paginapagina
Classi
Informativo (1xx)
La richiesta è stata ricevuta, l'elaborazione continuerà.
Successo (2xx)
La richiesta è stata compresa, accettata ed elaborata con successo.
Reindirizzamento (3xx)
È necessaria un'azione ulteriore del client per completare la richiesta.
Errore client (4xx)
La richiesta contiene errori o non può essere soddisfatta dal client.
Errore server (5xx)
Il server non è riuscito a completare una richiesta valida.
Codici comuni
200 OK: 200 OK – richiesta elaborata con successo.
301 Moved Permanently: 301 Moved Permanently – risorsa spostata definitivamente, aggiornare i link.
404 Not Found: 404 Not Found – risorsa non disponibile, restituire eventuale fallback.
500 Internal Server Error: 500 Internal Server Error – errore inatteso sul server, consultare i log.

❓Perché i codici HTTP sono importanti

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.

✨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.

📚Guida pratica

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.

💬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.

💡Come testare i codici HTTP

💻

Utilizza curl

Esegui `curl -I https://example.com` per vedere l'intestazione di risposta o `curl -X POST -d '{}' -o /dev/null -s -w '%{http_code}'` per stampare solo il codice.
🌐

Strumenti browser

Apri DevTools → Network per controllare lo status delle richieste, incluse chiamate fetch/XHR e asset statici.
📡

Monitoraggio e alert

Configura regole in strumenti APM (New Relic, Datadog) per generare alert su picchi di 4xx/5xx e misurare percentuali di errore.
🔁

Mock API

Usa Postman, Insomnia o Mock Service Worker per simulare risposte API con codici specifici e testare la UI.

📦Componenti consigliati

User Comments

0 / 2000
Loading...