Codici di stato HTTP

Cosa offre la pagina Codici di stato HTTP

Codici di stato HTTP è un riferimento ricercabile per i codici di risposta nell'intervallo da 100 a 599. È utile per fare debug delle chiamate API, scrivere documentazione, scegliere la risposta per un nuovo endpoint, leggere i log, verificare il comportamento di un gateway o spiegare un errore a un altro sviluppatore. Ogni voce include il codice numerico, la frase di motivazione, la categoria e una breve descrizione del significato abituale della risposta. Il filtro confronta codici, nomi, categorie e descrizioni, quindi puoi cercare valori esatti come 404, gruppi ampi come redirect o concetti come cache, auth, proxy, timeout e validazione.

L'elenco è incorporato direttamente nella pagina invece di essere recuperato da un servizio: per questo è veloce e disponibile anche quando lavori offline o stai risolvendo problemi di rete. Facendo clic su un risultato si copiano il codice e la frase, così è facile incollarli in commenti di issue, documenti, test o note sugli endpoint.

Flusso di lavoro privato nel browser

Tutta l'elaborazione avviene all'interno del tuo browser con JavaScript lato client. Lo strumento non carica su alcun server frammenti, valori di configurazione, dati generati, testi di query o esempi copiati e non richiede un account. Questo modello esclusivamente locale è importante per le utility per sviluppatori, perché i contenuti incollati assomigliano spesso a dati reali di un'applicazione: risposte API, log, esempi simili a variabili d'ambiente, query di database, markup di bozze o valori copiati da sessioni di debug in produzione. Mantenere la trasformazione in locale riduce i rischi e rende l'interazione rapida, perché non c'è alcun scambio di rete.

L'interfaccia è volutamente compatta, così puoi incollare l'input, regolare le opzioni, controllare l'output, copiarlo e tornare al tuo editor. I risultati vanno comunque rivisti prima di essere inseriti in un commit, condivisi pubblicamente o usati in un flusso di produzione. Gli strumenti nel browser sono eccellenti per ispezioni e preparazioni rapide, ma non possono conoscere ogni convenzione di progetto, regola di classificazione dei dati o requisito di validazione specifico dell'applicazione.

Consigli pratici

I codici di stato fanno parte del contratto di un'API, quindi scegliili con cura. Usa le risposte della famiglia 400 quando il client può modificare la richiesta, quelle della famiglia 500 quando il server non è riuscito a soddisfare una richiesta valida e quelle della famiglia 300 quando il client deve cercare altrove. Gli errori di autenticazione e di autorizzazione sono spesso confusi: 401 indica di solito che l'autenticazione è richiesta o non valida, mentre 403 significa che il chiamante autenticato non è autorizzato. Quando documenti le API, abbina al codice uno schema del corpo della risposta e indicazioni per la risoluzione.