Códigos de estado HTTP — oficiales y no oficiales

Qué hace Códigos de estado HTTP

Códigos de estado HTTP es una referencia con buscador de los códigos de respuesta del rango 100 al 599. Ayuda al depurar llamadas a API, redactar documentación, elegir una respuesta para un nuevo endpoint, leer registros, revisar el comportamiento de una pasarela o explicar un fallo a otro desarrollador. Cada entrada incluye el código numérico, la frase de motivo, la categoría, la RFC que lo define y una breve descripción de lo que suele significar la respuesta. Los chips de filtro reducen la lista a códigos informativos, de éxito, de redirección, de error del cliente o de error del servidor.

El tráfico real también contiene códigos que ningún estándar define. Un 499 en un registro de nginx significa que el cliente se rindió antes de que el servidor respondiera; un 522 de Cloudflare significa que el origen no completó el handshake TCP; un 460 o un 561 proceden de un balanceador de carga de AWS. Estos códigos no oficiales aparecen en su propio grupo junto con el producto que los emite, así que puedes saber rápidamente si un fallo vino de tu aplicación, de un proxy o de una CDN. Al hacer clic en un resultado se copian el código y la frase para comentarios de incidencias, documentación, pruebas o notas de endpoints.

Flujo de trabajo privado en el navegador

Todo el procesamiento se realiza dentro de tu navegador con JavaScript del lado del cliente. La lista está integrada 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, y nada de lo que escribes se envía a ninguna parte.

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, respuestas de la familia 500 cuando el servidor no haya podido atender una petición válida y respuestas de la familia 300 cuando el cliente deba buscar en otro sitio. Los fallos de autenticación y de autorización se confunden a menudo: 401 suele significar que se requiere autenticación o que no es válida, mientras que 403 significa que el llamante autenticado no tiene permiso. Prefiere 422 para errores de validación en un cuerpo bien formado, 409 para conflictos de estado y 429 con una cabecera Retry-After para la limitación de tasa. Nunca devuelvas códigos no oficiales desde tu propia API: los clientes y las bibliotecas pueden no entenderlos.