Elenco dei codici di stato HTTP per categoria
Selezioni una categoria di risposte HTTP e ottenga l’elenco completo e ordinato dei codici di stato standard assegnati, con le relative frasi descrittive.
Esegui gratis nel browser
Le cinque categorie supportate sono informativa, successo, reindirizzamento, errore del client ed errore del server, corrispondenti alle classi da 1xx a 5xx. Il risultato indica anche l’intervallo numerico e il numero di voci, risultando utile per documentazione, test, strumenti di sviluppo e consultazione rapida del protocollo senza inviare richieste di rete né esaminare un server attivo.
Scelga una delle cinque classi di risposta HTTP
I codici di stato HTTP sono raggruppati in base alla prima cifra. Le risposte informative occupano l’intervallo 100–199 e descrivono un avanzamento provvisorio prima della risposta finale. Le risposte di successo usano 200–299 e indicano che una richiesta è stata ricevuta, compresa o completata nel modo descritto dal codice specifico. I reindirizzamenti usano 300–399 per la selezione delle risorse, i cambiamenti di posizione, la convalida della cache e le relative decisioni di instradamento. Gli errori del client usano 400–499 quando la richiesta non può essere soddisfatta a causa della sintassi, delle credenziali, delle precondizioni, della destinazione, della frequenza o di un’altra condizione lato client. Gli errori del server usano 500–599 quando il server o un intermediario non riesce a completare una richiesta apparentemente valida. Inserisca una categoria: il risultato restituisce il nome canonico, l’intervallo numerico, il numero di voci e un array `statuses` in ordine crescente. Il confronto ignora maiuscole, spazi esterni, trattini e caratteri di sottolineatura. Le altre etichette vengono rifiutate esplicitamente, senza interpretazioni arbitrarie.
Interpreti correttamente codici e frasi descrittive
Ogni voce dell’array contiene un `code` numerico e la relativa `reason_phrase` standardizzata. La frase è una breve etichetta convenzionale, non una spiegazione completa delle condizioni in cui la risposta deve essere generata. Per esempio, 404 Not Found identifica il risultato, mentre la specifica HTTP applicabile definisce comportamento della cache, interazioni con i metodi e semantica della rappresentazione. Viene usata la terminologia moderna del registro quando le fonti precedenti sono diverse: 413 è Content Too Large e 422 è Unprocessable Content. Il codice 418 è incluso con l’etichetta di registro Unused; il noto riferimento alla teiera deriva da una precedente specifica sperimentale e non va considerato il titolo attuale del registro principale. Gli spazi non assegnati vengono omessi intenzionalmente, quindi una categoria non include necessariamente ogni intero del proprio intervallo. L’elenco è ordinato numericamente, così Lei può creare direttamente tabelle, confrontare i codici approvati o costruire un selettore. Le frasi sono metadati descrittivi: HTTP/2 e HTTP/3 non trasmettono tale campo, pertanto la logica dei client deve basarsi sul codice numerico.
Usi il risultato nella documentazione e nella convalida
Questa capacità è adatta quando uno strumento richiede un insieme di riferimento circoscritto anziché informazioni su una risposta attiva. Un generatore di documentazione può richiedere ogni categoria e creare tabelle coerenti. Una suite di test può verificare che un’applicazione emetta un codice registrato nella classe prevista, applicando comunque regole proprie sulle risposte consentite da ciascun endpoint. Un esploratore di API può compilare un menu raggruppato con le frasi restituite, mentre il materiale didattico può confrontare esiti provvisori, riusciti, di reindirizzamento, di errore del client e di errore del server. Il calcolo è una consultazione fissa in memoria: non esegue richieste di rete, non legge lo stato del server, non conserva l’input e produce lo stesso risultato per la medesima categoria normalizzata. Non decide se un codice sia appropriato per uno specifico caso aziendale, non aggiunge codici proprietari e non interpreta il corpo della risposta. Poiché i registri possono evolvere, chi necessita di una fonte giuridicamente o operativamente ufficiale deve conservare anche la versione della specifica adottata dal progetto. Il browser e l’API condividono questo risolutore deterministico; una chiamata API costa $0.002.
Casi d'uso
Creare tabelle per la documentazione API
Generi una tabella di riferimento ordinata per una classe di risposta, con codici numerici e frasi descrittive coerenti.
Convalidare le politiche di risposta
Confronti le risposte consentite da un’applicazione con i codici assegnati alla categoria HTTP prevista.
Alimentare gli strumenti per sviluppatori
Compili selettori raggruppati, schede di consultazione e interfacce didattiche con un risultato strutturato e deterministico.
Domande frequenti
Quali nomi di categoria sono accettati?
Usi informational, success, redirect, client error o server error. Il confronto ignora le maiuscole e accetta trattini o caratteri di sottolineatura nei nomi composti.
L’elenco include tutti i numeri dell’intervallo?
No. Include i codici standard assegnati e omette gli spazi non assegnati negli intervalli 1xx, 2xx, 3xx, 4xx o 5xx.
Perché lo stato 418 è denominato Unused?
L’attuale registro HTTP principale riserva 418 come Unused. Il noto riferimento alla teiera deriva da una specifica sperimentale.
È possibile controllare un URL attivo?
No. È una consultazione deterministica che non esegue richieste di rete. Usi una capacità di ispezione HTTP per esaminare un endpoint attivo.
Tutte le versioni HTTP trasmettono frasi descrittive?
No. Sono etichette convenzionali, e HTTP/2 e HTTP/3 non trasmettono un campo dedicato. La logica deve utilizzare il codice numerico.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/dev2/http-status-by-category \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"category":"client error"}'const res = await fetch("https://api.kit.forhosting.com/dev2/http-status-by-category", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"category": "client error"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev2/http-status-by-category",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"category": "client error"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/http-status-by-category", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"category":"client error"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"category":"client error"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/http-status-by-category", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"category": "client error"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev2.http_status_by_category",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |