Lista de códigos de estado HTTP por categoría
Seleccione una categoría de respuestas HTTP y obtenga una lista completa y ordenada de sus códigos de estado estándar asignados y sus frases descriptivas.
Ejecutar — gratis
Las cinco categorías admitidas son informativa, éxito, redirección, error del cliente y error del servidor, correspondientes a las clases 1xx a 5xx. El resultado también indica el intervalo numérico y la cantidad de entradas, por lo que resulta útil para documentación, pruebas, herramientas de desarrollo y consultas rápidas del protocolo sin enviar solicitudes de red ni inspeccionar servidores activos.
Elija una de las cinco clases de respuesta HTTP
Los códigos de estado HTTP se agrupan según su primer dígito. Las respuestas informativas ocupan el intervalo 100–199 y describen avances provisionales antes de una respuesta final. Las respuestas de éxito utilizan 200–299 e indican que una solicitud se recibió, comprendió o completó según lo descrito por el código concreto. Las redirecciones usan 300–399 para seleccionar recursos, indicar ubicaciones nuevas, validar cachés y tomar decisiones de encaminamiento relacionadas. Los errores del cliente usan 400–499 cuando la solicitud no se puede atender debido a su sintaxis, credenciales, condiciones previas, destino, frecuencia u otra circunstancia del cliente. Los errores del servidor usan 500–599 cuando el servidor o un intermediario no puede completar una solicitud aparentemente válida. Introduzca una categoría y el resultado devolverá su nombre canónico, intervalo numérico, número de entradas y una matriz `statuses` ascendente. La comparación ignora mayúsculas, espacios externos, guiones y guiones bajos. Las demás etiquetas se rechazan claramente en vez de interpretarse mediante conjeturas.
Interprete correctamente los códigos y las frases descriptivas
Cada entrada de la matriz contiene un `code` numérico y su `reason_phrase` estandarizada. La frase es una etiqueta convencional breve, no una explicación completa de cuándo debe generarse la respuesta. Por ejemplo, 404 Not Found identifica el resultado, mientras que la especificación HTTP aplicable define el comportamiento de caché, las interacciones con métodos y la semántica de la representación. Se utiliza la terminología moderna del registro cuando difiere de referencias antiguas: 413 es Content Too Large y 422 es Unprocessable Content. El código 418 aparece con la etiqueta de registro Unused; la conocida referencia a la tetera procede de una especificación experimental anterior y no debe considerarse su título actual en el registro principal. Los huecos no asignados se omiten deliberadamente, por lo que una categoría no contiene necesariamente todos los enteros de su intervalo. La lista se ordena numéricamente para que usted pueda generar tablas, comparar códigos permitidos o crear selectores sin ordenación adicional. Las frases son metadatos descriptivos: HTTP/2 y HTTP/3 no transmiten ese campo, y la lógica debe basarse en el código numérico.
Utilice el resultado en documentación y validaciones
Esta capacidad resulta adecuada cuando una herramienta necesita un conjunto de referencia limitado en lugar de información sobre una respuesta activa. Un generador de documentación puede solicitar cada categoría y crear tablas coherentes. Un banco de pruebas puede verificar que una aplicación emite un código registrado de la clase esperada y aplicar además sus propias reglas sobre las respuestas permitidas en cada endpoint. Un explorador de API puede rellenar un menú agrupado con las frases devueltas, y el material didáctico puede comparar resultados provisionales, satisfactorios, de redirección, de error del cliente y de error del servidor. El cálculo es una consulta fija en memoria: no realiza solicitudes de red, no lee el estado de servidores, no almacena entradas y genera el mismo resultado para la misma categoría normalizada. No determina si un código es apropiado para un caso empresarial concreto, no amplía códigos de proveedores ni interpreta cuerpos de respuesta. Como los registros pueden evolucionar, los consumidores que necesiten una referencia jurídicamente u operativamente autoritativa también deben conservar la versión de la especificación usada en su proyecto. El navegador y la API comparten este solucionador determinista; una llamada a la API cuesta $0.002.
Qué puede hacer con ella
Crear tablas de documentación de API
Genere una tabla de referencia ordenada para una clase de respuesta con códigos numéricos y frases descriptivas coherentes.
Validar políticas de respuesta
Compare las respuestas permitidas por una aplicación con los códigos asignados de la categoría HTTP prevista.
Rellenar herramientas para desarrolladores
Complete selectores agrupados, hojas de consulta e interfaces formativas a partir de un resultado estructurado y determinista.
Preguntas frecuentes
¿Qué nombres de categoría se aceptan?
Utilice informational, success, redirect, client error o server error. La comparación no distingue mayúsculas y admite guiones o guiones bajos en nombres compuestos.
¿La lista incluye todos los números del intervalo?
No. Incluye códigos estándar asignados y omite los huecos no asignados de cada intervalo 1xx, 2xx, 3xx, 4xx o 5xx.
¿Por qué el estado 418 se denomina Unused?
El registro HTTP principal actual reserva 418 como Unused. La conocida denominación relacionada con una tetera procede de una especificación experimental.
¿Puede comprobar una URL activa?
No. Es una consulta de referencia determinista y no realiza solicitudes de red. Utilice una capacidad de inspección HTTP para examinar un endpoint activo.
¿Todas las versiones HTTP transmiten frases descriptivas?
No. Son etiquetas convencionales, y HTTP/2 y HTTP/3 no transmiten un campo de frase descriptiva. La lógica debe usar el código numérico.
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/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)Ejemplo de solicitud
{
"category": "client error"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev2.http_status_by_category",
"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.
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. |