100
Continue
Il server ha ricevuto gli header e il client può continuare a inviare il body. Evita payload grandi se il server potrebbe rifiutare la richiesta.
Tutte le utilità
Riferimento
Codici di stato HTTP
Riferimento consultabile dei codici di risposta HTTP comuni.
1xx Informativi
101
Switching Protocols
Il server accetta di cambiare protocollo (ad es. da HTTP a WebSocket) come richiesto dall'header Upgrade.
102
Processing
Il server ha ricevuto ed elabora la richiesta, ma non c'è ancora un body di risposta. Usato per operazioni di lunga durata.
2xx Successo
200
OK
Richiesta riuscita. Il body di risposta contiene tipicamente la risorsa richiesta o il risultato dell'operazione.
201
Created
Richiesta riuscita e nuova risorsa creata. Spesso restituito dopo POST con header Location che punta alla nuova risorsa.
202
Accepted
Richiesta accettata per l'elaborazione ma non ancora completata. Comune per job async e task in background.
204
No Content
Richiesta riuscita ma nessun contenuto da restituire. Tipico di DELETE o PUT riusciti con body vuoto.
3xx Reindirizzamento
301
Moved Permanently
La risorsa è stata spostata permanentemente a un nuovo URL. Client e motori di ricerca devono aggiornare segnalibri e link.
302
Found
La risorsa è temporaneamente disponibile a un URL diverso. Le richieste future possono ancora usare l'URL originale.
303
See Other
Dopo un POST, il client deve recuperare il risultato con GET all'URL indicato nell'header Location.
304
Not Modified
La versione in cache è ancora valida. Il server non restituisce body; il client deve usare la cache locale.
307
Temporary Redirect
Redirect temporaneo che mantiene il metodo HTTP originale. A differenza del vecchio 302, POST resta POST dopo il redirect.
308
Permanent Redirect
Redirect permanente che mantiene il metodo HTTP originale. Il client deve usare il nuovo URL per le richieste future.
4xx Errore client
400
Bad Request
Il server non può elaborare la richiesta per sintassi non valida, campi mancanti o JSON malformato. Correggi la richiesta e riprova.
401
Unauthorized
Autenticazione richiesta o fallita. Il client deve fornire credenziali valide, spesso tramite header Authorization o login.
403
Forbidden
Il server ha compreso la richiesta ma rifiuta di autorizzarla. L'utente potrebbe essere autenticato ma senza permesso.
404
Not Found
L'URL o la risorsa richiesta non esiste. Controlla path, route o ID — oppure l'elemento potrebbe essere stato rimosso.
405
Method Not Allowed
Il metodo HTTP non è consentito per questo endpoint. Ad esempio, inviare POST dove è supportato solo GET.
408
Request Timeout
Il server ha esaurito il timeout in attesa della richiesta completa. Spesso per upload lenti o connessioni inattive.
409
Conflict
La richiesta è in conflitto con lo stato attuale della risorsa. Comune quando si creano duplicati o si violano vincoli di versione.
410
Gone
La risorsa esisteva ma è stata rimossa definitivamente e non sarà più disponibile. Più forte del 404 per contenuti eliminati.
413
Payload Too Large
Il body della richiesta è più grande di quanto il server possa elaborare. Riduci la dimensione del payload o usa upload chunked.
414
URI Too Long
L'URL della richiesta supera il limite del server. Accorcia le query string o sposta i dati nel body.
415
Unsupported Media Type
Il server non supporta il Content-Type della richiesta. Invia JSON, dati form o un altro formato accettato dall'API.
418
I'm a teapot
Definito in RFC 2324 come scherzo del pesce d'aprile: il server rifiuta di preparare caffè perché è una teiera. A volte usato nelle demo.
422
Unprocessable Entity
La richiesta è sintatticamente valida ma semanticamente errata. Tipico degli errori di validazione in API REST e form web.
429
Too Many Requests
Il client ha inviato troppe richieste in un intervallo di tempo. Rispetta Retry-After e implementa backoff o rate limiting.
5xx Errore server
500
Internal Server Error
Si è verificato un errore imprevisto sul server. Di solito non è colpa del client — controlla i log del server e riprova più tardi.
501
Not Implemented
Il server non supporta la funzionalità richiesta. Il metodo o la funzione non è implementata.
502
Bad Gateway
Un gateway o proxy ha ricevuto una risposta non valida da un server upstream. Spesso dietro load balancer quando i backend falliscono.
503
Service Unavailable
Il server è temporaneamente non disponibile, spesso per manutenzione o sovraccarico. Riprova dopo un ritardo; controlla Retry-After se presente.
504
Gateway Timeout
Un gateway o proxy non ha ricevuto una risposta tempestiva dal server upstream. Indica lentezza del backend o problemi di rete.
32 codici di stato HTTP comuni
Informazioni sullo strumento
Browse HTTP status codes with this practical reference for API development and debugging. The HTTP status reference explains response classes and common edge cases from informational to server error codes.
Engineers use it to align backend behavior, frontend handling, and monitoring alerts around consistent semantics. Clear status code usage improves observability and client integration reliability.
Domande frequenti
- Why use an HTTP status reference during development?
- It helps choose correct response codes for each outcome so clients can handle success and failure conditions predictably.
- What is the difference between 4xx and 5xx?
- 4xx indicates client-side request issues, while 5xx indicates server-side failure or unavailable upstream behavior.
- Can this help improve API monitoring?
- Yes, understanding status semantics enables better alert thresholds and faster diagnosis of incident patterns.