Continua
Continue
Il server ha ricevuto gli header: il client può inviare il body.
Web e tempo
Codici di stato HTTP
Riferimento ricercabile ai codici da 1xx a 5xx.
Cambio protocollo
Switching Protocols
Il server accetta il cambio di protocollo, di solito verso WebSocket.
Hint anticipati
Early Hints
Header preliminari per far precaricare risorse prima della risposta finale.
OK
OK
Richiesta riuscita, la risposta contiene il risultato.
Creato
Created
Una nuova risorsa è stata creata. Invia il suo URL nell'header Location.
Accettato
Accepted
La richiesta è stata presa in carico ma non è ancora completata.
Nessun contenuto
No Content
Richiesta riuscita senza body, tipico per DELETE.
Contenuto parziale
Partial Content
Restituisce parte di una risorsa: range request e streaming.
Multi-stato
Multi-Status
Risposta WebDAV con stati separati per più operazioni.
IM usato
IM Used
Il server ha applicato delta encoding alla rappresentazione, RFC 3229.
Scelte multiple
Multiple Choices
Esistono più rappresentazioni: il client o l'utente deve sceglierne una.
Spostato permanentemente
Moved Permanently
La risorsa ha un nuovo URL permanente. I motori trasferiscono i segnali.
Trovato
Found
Redirect temporaneo: mantieni l'URL originale per le richieste future.
Vedi altrove
See Other
Redirect del client con GET, spesso dopo una POST.
Non modificato
Not Modified
La copia in cache è ancora valida e viene riutilizzata.
Redirect temporaneo
Temporary Redirect
Come 302, ma il metodo HTTP non deve cambiare.
Redirect permanente
Permanent Redirect
Come 301, ma metodo e body vengono preservati.
Richiesta errata
Bad Request
Richiesta malformata o non valida. Spiega l'errore nel body.
Non autenticato
Unauthorized
Autenticazione assente o non valida: il server non sa chi sei.
Pagamento richiesto
Payment Required
Riservato all'accesso a pagamento. Raro, utile per quote API.
Vietato
Forbidden
Il server conosce il client ma nega l'accesso. Ripetere il login non serve.
Non trovato
Not Found
Nessuna risorsa corrisponde all'URL. Usato anche per nascondere risorse private.
Metodo non consentito
Method Not Allowed
L'URL esiste ma non supporta questo metodo. Invia l'header Allow.
Non accettabile
Not Acceptable
Nessuna rappresentazione corrisponde agli header Accept del client.
Autenticazione proxy
Proxy Authentication Required
Il client deve autenticarsi con il proxy prima di procedere.
Timeout richiesta
Request Timeout
Il server ha atteso troppo la richiesta. Il client può riprovare.
Conflitto
Conflict
La richiesta confligge con lo stato attuale: duplicato o versione obsoleta.
Sparito
Gone
La risorsa esisteva ma è stata rimossa definitivamente. Più forte di 404.
Lunghezza richiesta
Length Required
La richiesta deve includere l'header Content-Length.
Precondizione fallita
Precondition Failed
Un header condizionale come If-Match è risultato falso.
Contenuto troppo grande
Content Too Large
Il body supera il limite del server. Alzalo o usa upload in streaming.
URI troppo lungo
URI Too Long
L'URL supera il limite del server. Sposta i dati nel body.
Media non supportato
Unsupported Media Type
Il formato del payload non è supportato. Controlla Content-Type.
Range non valido
Range Not Satisfiable
Il range di byte richiesto non è disponibile. Invia Content-Range.
Aspettativa fallita
Expectation Failed
Il server non può soddisfare l'header Expect.
Sono una teiera
I'm a Teapot
RFC scherzosa del primo aprile. Alcune API la usano come errore ironico.
Richiesta mal diretta
Misdirected Request
La richiesta è arrivata a un server che non può rispondere per questo host.
Contenuto non processabile
Unprocessable Content
La sintassi è valida ma il contenuto non supera la validazione semantica.
Bloccato
Locked
La risorsa è bloccata da un'altra operazione, comune in WebDAV.
Dipendenza fallita
Failed Dependency
Richiesta fallita perché una richiesta dipendente precedente è fallita.
Troppo presto
Too Early
Il server rifiuta una richiesta che potrebbe essere replicata (TLS early data).
Upgrade richiesto
Upgrade Required
Il client deve passare a un altro protocollo, come TLS o HTTP/2.
Precondizione richiesta
Precondition Required
Il server richiede una richiesta condizionale per evitare update persi.
Troppe richieste
Too Many Requests
Rate limit superato. Invia Retry-After e documenta la quota.
Header troppo grandi
Request Header Fields Too Large
Gli header superano il limite del server. Spesso dipende dai cookie.
Non disponibile per motivi legali
Unavailable For Legal Reasons
Bloccato per motivi legali, come censura o ordine del tribunale.
Errore interno
Internal Server Error
Errore inatteso del server. Loggalo, ma non esporre dettagli ai client.
Non implementato
Not Implemented
Il server non supporta la funzionalità o il metodo richiesto.
Bad gateway
Bad Gateway
Un proxy ha ricevuto una risposta non valida da un server upstream.
Servizio non disponibile
Service Unavailable
Server sovraccarico o in manutenzione. Invia Retry-After.
Timeout gateway
Gateway Timeout
Un proxy non ha ricevuto risposta in tempo da un server upstream.
Versione HTTP non supportata
HTTP Version Not Supported
Il server non supporta la versione HTTP usata nella richiesta.
Spazio insufficiente
Insufficient Storage
Il server non può salvare la rappresentazione. Comune in WebDAV.
Loop rilevato
Loop Detected
Il server ha rilevato un loop infinito durante la richiesta.
Non esteso
Not Extended
La richiesta richiede ulteriori estensioni per essere soddisfatta.
Autenticazione di rete
Network Authentication Required
Il client deve autenticarsi per avere rete, come in un captive portal.
Nessun codice trovato.
Cosa fa questo tool
I codici di stato HTTP dicono al client cosa è successo a una richiesta. La prima cifra identifica la classe: informativa, successo, redirect, errore del client o del server. Questo riferimento elenca i codici che si incontrano davvero in API e browser, con una spiegazione breve e una casella di ricerca.
Come si usa
- Cerca un codice o una parola chiave.
- Filtra per classe per una vista ampia.
- Leggi il significato e scegli il codice giusto.
Domande
401 vs 403?
401 significa non autenticato: il server non sa chi sei. 403 significa autenticato ma non autorizzato a questa risorsa.
200 vs 201?
200 è un successo generico per letture e aggiornamenti. 201 indica che una risorsa è stata creata e dovrebbe includere Location.
Si possono inventare codici?
I client capiscono la classe dalla prima cifra, ma inventare codici danneggia l'interoperabilità. Usa un codice standard e spiega i dettagli nel body.