Códigos de estado HTTP

Qué ofrece la página Códigos de estado HTTP

Códigos de estado HTTP es una referencia con búsqueda para los códigos de respuesta del rango 100 a 599. Ayuda al depurar llamadas a APIs, redactar documentación, elegir la respuesta de un nuevo endpoint, leer registros, revisar el comportamiento de un gateway o explicar un fallo a otro desarrollador. Cada entrada incluye el código numérico, la frase descriptiva, la categoría y una breve descripción de lo que suele significar la respuesta. El filtro busca en códigos, nombres, categorías y descripciones, de modo que puedes buscar valores exactos como 404, grupos amplios como redirect o conceptos como cache, auth, proxy, timeout y validación.

La lista está incrustada directamente en la página en lugar de obtenerse de un servicio, lo que la hace rápida y disponible incluso cuando trabajas sin conexión o depuras problemas de red. Al hacer clic en un resultado se copian el código y la frase, lo que facilita pegarlos en comentarios de incidencias, documentos, pruebas o notas de endpoints.

Flujo de trabajo privado en el navegador

Todo el procesamiento ocurre dentro de tu navegador con JavaScript del lado del cliente. La herramienta no sube fragmentos, valores de configuración, datos generados, textos de consultas ni ejemplos copiados a ningún servidor, y no requiere una cuenta. Este modelo exclusivamente local es importante en las utilidades para desarrolladores, porque el contenido que se pega en ellas suele parecerse a datos reales de una aplicación: respuestas de API, registros, muestras con forma de variables de entorno, consultas a bases de datos, marcado de borradores o valores copiados de sesiones de depuración en producción. Mantener la transformación en local reduce riesgos y hace la interacción rápida, porque no hay viaje de ida y vuelta por la red.

La interfaz es compacta a propósito para que puedas pegar la entrada, ajustar las opciones, inspeccionar la salida, copiarla y volver a tu editor. Aun así, conviene revisar los resultados antes de confirmarlos en un commit, compartirlos públicamente o usarlos en un flujo de producción. Las herramientas del navegador son excelentes para inspeccionar y preparar con rapidez, pero no pueden conocer todas las convenciones de un proyecto, reglas de clasificación de datos o requisitos de validación propios de una aplicación.

Consejos prácticos

Los códigos de estado forman parte del contrato de una API, así que elígelos con criterio. Usa respuestas de la familia 400 cuando el cliente pueda cambiar la petición, de la familia 500 cuando el servidor no haya podido cumplir una petición válida y de la familia 300 cuando el cliente deba buscar en otro lugar. Los fallos de autenticación y de autorización suelen confundirse: 401 normalmente significa que se requiere autenticación o que no es válida, mientras que 403 significa que el usuario autenticado no tiene permiso. Al documentar APIs, acompaña el código con un esquema del cuerpo de la respuesta y pautas para solucionar el problema.