Codici di Stato HTTP

401 Unauthorized significa che è richiesta l'autenticazione — il server non sa chi sei. Di solito include un'intestazione WWW-Authenticate che ti invita ad accedere. 403 Forbidden significa che il server sa chi sei (o l'autenticazione non è il problema) ma non hai il permesso. Pensa al 401 come «mostrami il tuo documento» e al 403 come «vedo il tuo documento ma non sei nella lista».

Un 502 compare quando un proxy, un load balancer o una CDN riceve una risposta non valida dal server upstream contattato per tuo conto. Cause comuni: il server upstream è andato in crash, è sovraccarico, si è riavviato durante la richiesta o ha restituito intestazioni HTTP malformate. Il proxy stesso funziona bene — è ciò con cui il proxy sta comunicando che è difettoso. Controlla i log del server applicativo e riavvialo se necessario.

301 Moved Permanently dice ai browser e ai motori di ricerca che la risorsa si è spostata definitivamente — devono aggiornare i segnalibri e trasferire il link equity. 302 Found è temporaneo — i client devono continuare a usare l'URL originale. Per la SEO, usa sempre il 301 per le modifiche permanenti degli URL. Usare il 302 per errore in uno spostamento permanente può dividere i segnali di ranking e causare una propagazione lenta.

418 è uno scherzo del Pesce d'Aprile dell'RFC 2324 (1998) — il Hyper Text Coffee Pot Control Protocol. Il presupposto: un server che è, di fatto, una teiera dovrebbe rifiutarsi di preparare caffè. Era un RFC satirico di Larry Masinter. Nonostante fosse uno scherzo, è stato mantenuto nel registro IANA ed è diventato una tradizione amata nello sviluppo web. Alcuni server lo usano per rifiutare umoristicamente bot o automazioni indesiderate.

429 significa che hai superato un limite di frequenza — stai inviando troppe richieste in poco tempo. Soluzione lato client: aspetta e riprova dopo il ritardo specificato nell'intestazione Retry-After, implementa un backoff esponenziale e metti in cache le risposte dove possibile. Lato server: includi sempre un'intestazione Retry-After; usa algoritmi a finestra scorrevole o token bucket per una limitazione equa.

Usa 404 Not Found quando la risorsa non esiste ma potrebbe farlo in futuro (o se non sei sicuro che sia mai esistita). Usa 410 Gone quando sai che la risorsa esisteva in precedenza ed è stata eliminata definitivamente senza sostituzione. Per la SEO, 410 segnala ai motori di ricerca di rimuovere l'URL dal loro indice più rapidamente rispetto a un 404.