Codice di stato HTTP
Un codice di stato HTTP è compatto, ma il solo numero non è sempre facile da ricordare.
Esegui gratis nel browser
Questa ricerca converte un codice da 100 a 599 nella frase standard e nella categoria generale: informazione, successo, reindirizzamento, errore del client o errore del server. È utile per leggere log, eseguire il debug di un’integrazione, controllare avvisi di monitoraggio o spiegare una risposta API. Il risultato è deterministico, non effettua richieste di rete e segnala chiaramente i codici validi che non hanno ancora un’assegnazione standard.
Legga un codice di risposta senza interrompere il lavoro
Le risposte HTTP inseriscono un codice di stato a tre cifre all’inizio dei metadati del protocollo. Quando il codice compare in una riga di log, in un rapporto di consegna webhook, nella console del browser, in una traccia di proxy inverso o in un’eccezione del client API, questa ricerca fornisce subito un’etichetta leggibile. Inserisca un numero intero tra 100 e 599. Il risultato ripete il codice normalizzato, presenta la frase registrata o comunemente standardizzata e identifica la categoria rappresentata dalla prima cifra. Per esempio, 404 corrisponde a “Not Found” e a un errore del client, mentre 503 corrisponde a “Service Unavailable” e a un errore del server. Si tratta di una consultazione di riferimento, non di una richiesta HTTP: non contatta il sito interessato, non verifica lo stato di un endpoint e non deduce la causa della risposta. L’output rimane quindi stabile e adatto a documentazione, strumenti di assistenza, script da riga di comando, arricchimento dei log e interfacce didattiche, senza latenza di rete né esposizione di URL privati.
Comprenda categorie e valori non assegnati
Le cinque categorie derivano direttamente dalla cifra delle centinaia. I codici da 100 a 199 sono informativi e descrivono una risposta provvisoria. Da 200 a 299 indicano successo. Da 300 a 399 riguardano un reindirizzamento o un altro passaggio necessario per completare il recupero. Da 400 a 499 descrivono un errore del client, cioè una richiesta che non può essere soddisfatta nella forma corrente. Da 500 a 599 descrivono un errore del server durante la gestione di una richiesta apparentemente valida. Non tutti i numeri compresi in questi intervalli hanno una frase assegnata. Un valore come 299 appartiene strutturalmente ai successi, ma non possiede una frase standard nella tabella; il risultato riporta quindi “Non assegnato” mantenendo la categoria corretta. La distinzione evita di confondere un intervallo valido per estensioni HTTP con un input malformato e impedisce di inventare descrizioni fuorvianti. Sono considerati non validi soltanto i valori fuori da 100–599, i numeri frazionari e gli input non numerici.
Usi correttamente il risultato nel debug e nell’automazione
Una frase di stato è un’etichetta concisa, non una diagnosi. Se un’API restituisce 401 Unauthorized, la frase identifica la semantica della risposta, ma la soluzione concreta può richiedere un token, il rinnovo della sessione, la correzione di una firma o la verifica di una regola descritta nel corpo. Analogamente, 500 Internal Server Error indica un problema lato server senza rivelare quale componente sia guasto. Usi questa ricerca come primo passo interpretativo, poi controlli intestazioni, corpo, metodo della richiesta, indicazioni sui tentativi successivi e documentazione del servizio. Nell’automazione, la categoria è spesso più stabile della frase: una regola può raggruppare tutte le risposte 500–599 come errori del server, mentre un’interfaccia mostra il testo preciso. Quando è necessario un comportamento esatto, il software deve comunque verificare il codice numerico. L’API costa $0.002 per richiesta e restituisce piccoli campi JSON facili da archiviare o visualizzare. Poiché il calcolo è locale e deterministico, lo stesso input produce sempre lo stesso output.
Casi d'uso
Interpretare i log delle applicazioni
Trasformi codici numerici isolati in frasi e categorie leggibili durante l’analisi delle richieste.
Arricchire gli avvisi di monitoraggio
Aggiunga una frase stabile e la categoria dell’errore prima che l’avviso raggiunga il personale reperibile.
Spiegare il comportamento di un’API
Fornisca a sviluppo e assistenza un significato convenzionale conciso per documentazione o ticket.
Domande frequenti
Quale input accetta la ricerca?
Inserisca un codice di stato HTTP intero da 100 a 599. I valori fuori intervallo e non interi restituiscono un errore di input non valido.
Cosa accade se il codice è nell’intervallo ma non ha una frase standard?
La frase restituita è “Non assegnato” e la categoria continua a derivare dalla prima cifra.
Questo strumento invia una richiesta a un sito web?
No. Esegue una ricerca locale deterministica e non contatta alcun URL o servizio esterno.
La frase consente di conoscere la causa principale di un errore?
No. Indica il significato convenzionale. Consulti corpo, intestazioni, log e documentazione per diagnosticare la causa specifica.
Quanto costa la ricerca tramite API?
Ogni richiesta API costa $0.002. La versione per browser viene eseguita localmente e gratuitamente.
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/web/http-status-lookup \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"code":404}'const res = await fetch("https://api.kit.forhosting.com/web/http-status-lookup", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"code": 404
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/web/http-status-lookup",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"code": 404
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/http-status-lookup", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"code":404}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"code":404}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/http-status-lookup", 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
{
"code": 404
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "web.http_status_lookup",
"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.
Limiti
timeout_sec | 30 |
max_crawl_pages | 25 |
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. |