Consultar código HTTP
Un código de estado HTTP es breve, pero no siempre resulta fácil recordar qué significa cada número.
Ejecutar — gratis
Esta consulta convierte un código del 100 al 599 en su frase estándar y en su categoría general: informativo, correcto, redirección, error del cliente o error del servidor. Es útil al leer registros, depurar una integración, revisar alertas de supervisión o explicar una respuesta de API. El resultado es determinista, no realiza solicitudes de red e identifica con claridad los códigos válidos que aún no tienen una asignación estándar.
Interprete una respuesta sin interrumpir su trabajo
Las respuestas HTTP incluyen un código de estado de tres cifras al principio de los metadatos del protocolo. Cuando aparece en una línea de registro, un informe de entrega de webhook, la consola del navegador, una traza de proxy inverso o una excepción del cliente de API, esta herramienta muestra de inmediato una etiqueta comprensible. Introduzca un entero entre 100 y 599. El resultado repite el código normalizado, ofrece su frase registrada o de uso estandarizado e indica la categoría definida por la primera cifra. Por ejemplo, 404 corresponde a «Not Found» y a un error del cliente, mientras que 503 corresponde a «Service Unavailable» y a un error del servidor. Se trata de una consulta de referencia, no de una solicitud HTTP: no contacta con el sitio afectado, no comprueba la salud de un endpoint ni deduce la causa de una respuesta. Por ello, la salida es estable y apta para documentación, soporte, scripts de línea de comandos, enriquecimiento de registros e interfaces educativas, sin añadir latencia de red ni revelar una URL privada.
Comprenda las categorías y los valores sin asignar
Las cinco categorías se obtienen directamente de la cifra de las centenas. Los códigos del 100 al 199 son informativos y describen una respuesta provisional. Del 200 al 299 indican éxito. Del 300 al 399 señalan una redirección u otro paso necesario para completar la recuperación. Del 400 al 499 describen un error del cliente: la solicitud no puede atenderse en su forma actual. Del 500 al 599 describen un error del servidor durante el tratamiento de una solicitud aparentemente válida. No todos los números de esos intervalos tienen una frase asignada. Un valor como 299 pertenece estructuralmente a la categoría de éxito, pero carece de frase estándar en la tabla; por eso, el resultado indica «Sin asignar» y conserva la categoría correcta. Esta diferencia evita confundir un intervalo válido para extensiones HTTP con una entrada mal formada y evita inventar frases engañosas. Solo se rechazan los valores fuera del 100 al 599, las fracciones y las entradas no numéricas.
Use el resultado correctamente al depurar y automatizar
Una frase de estado es una etiqueta breve, no un diagnóstico. Si una API devuelve 401 Unauthorized, la frase describe la semántica de la respuesta, pero la solución concreta puede ser aportar un token, renovar una sesión, corregir una firma o revisar una política indicada en el cuerpo. Del mismo modo, 500 Internal Server Error señala un fallo del servidor sin identificar el componente responsable. Use esta consulta como primer paso y examine después las cabeceras, el cuerpo, el método, las recomendaciones de reintento y la documentación del servicio. Para automatización, la categoría suele ser más estable que la frase: una regla puede agrupar todas las respuestas 500–599 como errores del servidor y una interfaz puede mostrar el texto específico a las personas. Cuando el comportamiento exacto sea importante, el software debe decidir según el código numérico. La API cuesta $0.002 por solicitud y devuelve campos JSON pequeños, fáciles de guardar o mostrar. Como el cálculo es local y determinista, una misma entrada siempre produce la misma salida.
Qué puede hacer con ella
Interpretar registros de aplicaciones
Convierta códigos numéricos aislados en frases y categorías legibles mientras investiga solicitudes.
Enriquecer alertas de supervisión
Añada una frase estable y una categoría de error antes de que la alerta llegue al personal de guardia.
Explicar el comportamiento de una API
Ofrezca a desarrollo y soporte un significado convencional y conciso para documentación o incidencias.
Preguntas frecuentes
¿Qué entrada acepta la consulta?
Indique un código de estado HTTP entero del 100 al 599. Los valores fuera del intervalo y los no enteros producen un error de entrada no válida.
¿Qué ocurre si el código está en el intervalo pero no tiene frase estándar?
La frase se devuelve como «Sin asignar» y la categoría se sigue obteniendo de la primera cifra.
¿Esta herramienta envía una solicitud a un sitio web?
No. Realiza una consulta local determinista y no contacta con ninguna URL ni servicio externo.
¿La frase permite conocer la causa raíz del error?
No. Expresa el significado convencional. Consulte el cuerpo, las cabeceras, los registros y la documentación para diagnosticar la causa concreta.
¿Cuánto cuesta la consulta por API?
Cada solicitud por API cuesta $0.002. La versión del navegador se ejecuta localmente de forma gratuita.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su 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)Ejemplo de solicitud
{
"code": 404
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "web.http_status_lookup",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
timeout_sec | 30 |
max_crawl_pages | 25 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |