Tu API es la columna vertebral de tu producto. Cuando se cae (o se pone lenta) tus clientes lo sienten. Pero la mayoría de los equipos maneja las caídas de forma reactiva: los usuarios se quejan, alguien revisa los logs, y 30 minutos después sale una respuesta. Una página de estado pública da vuelta esa dinámica. Permite que tus clientes verifiquen la salud de la API por su cuenta, en tiempo real, sin abrir un ticket.

En este tutorial vas a ver qué hace que una página de estado sea buena, cómo armar una paso a paso y cómo incrustar badges de uptime directamente en tu documentación.

¿Qué es una página de estado y por qué la necesitás?

Una página de estado es una página accesible públicamente que muestra el estado actual de los endpoints de tu API. Es como un dashboard en vivo para tus clientes, sin necesidad de iniciar sesión.

  • La transparencia genera confianzacuando los clientes pueden ver los datos de uptime por su cuenta, confían más en tu servicio.
  • Menos tickets de soportedurante una caída, lo primero que hacen los usuarios es preguntar "¿Soy solo yo?". Una página de estado responde eso al instante, reduciendo el volumen de soporte entre un 30-50%.
  • Comunicación de incidentes más rápidaen lugar de escribir respuestas individuales, actualizás una sola página que llega a todos los usuarios afectados.
  • Ventaja competitivamuchas APIs todavía no tienen una página de estado pública. Tener una te diferencia como un proveedor serio y confiable.

DIY vs páginas de estado hospedadas

Podés construirla vos mismo o usar una solución hospedada. El enfoque DIY te da control total sobre el diseño, pero tenés que construir y mantener la lógica de monitoreo, y si tu infraestructura se cae, tu página de estado también puede caerse. Una solución hospedada está lista en minutos, corre en infraestructura independiente e incluye el monitoreo, sin mantenimiento.

Para la mayoría de los equipos (especialmente startups e indie hackers) una página de estado hospedada es la mejor opción.

Qué debe mostrar una buena página de estado

Una página que solo dice "Todos los sistemas operativos" con un punto verde es casi inútil. Esto es lo que una buena página de estado debe mostrar:

  • Estado por endpointla salud de cada endpoint individual, no solo un agregado.
  • Línea de tiempo de uptimeuna visualización de 30 días que muestra cuándo cada endpoint estuvo activo, degradado o caído.
  • Porcentaje de uptime generalun número claro (ej: 99.97%) que resume la confiabilidad en un período.
  • Hora del último chequeoun timestamp que demuestra que los datos son frescos.

Cómo armar una página de estado pública, paso a paso

Ya sea que uses una herramienta hospedada o la construyas vos, el proceso tiene los mismos cuatro pasos.

Paso 1: Elegí los endpoints y empezá a chequearlos

Listá los endpoints de los que realmente dependen tus clientes y apuntá un chequeo de uptime externo a cada uno, idealmente desde más de una región, para que los datos vengan de afuera de tu propia infraestructura.

Paso 2: Publicá la página en infraestructura independiente

Activá la página pública en tu herramienta de monitoreo, o desplegá tu página DIY en otro proveedor. Dale una URL estable y fácil de recordar, típicamente un subdominio como:

https://status.tudominio.com

Cualquier persona con la URL puede ver la página, no se requiere autenticación. Eso sí: que no corra en los mismos servidores que monitorea.

Paso 3: Elegí qué mostrar

Decidí qué endpoints aparecen en la página de estado. Quizás quieras mostrar tus rutas de API públicas pero ocultar endpoints administrativos internos.

Paso 4: Compartí el enlace

Tu página de estado ya está en vivo. Los visitantes ven el estado actual de cada endpoint, una línea de tiempo de 30 días, el porcentaje de uptime general y la hora del último chequeo.

Badges de uptime embebibles

Además de la página de estado, muchas herramientas de uptime ofrecen badges SVG embebibles, parecidos a los badges de build que ves en los READMEs de GitHub. Un badge suele ser un SVG servido desde una URL estable por endpoint:

![API Uptime](https://status.tudominio.com/badge/tu-endpoint-id.svg)

El esquema típico de colores es verde (activo), amarillo (latencia elevada), rojo (caído), y suelen cachearse unos minutos. Incrustalos en tu README de GitHub, documentación de API o landing page.

Página de estado vs monitoreo

Un error común es pensar que una página de estado reemplaza el monitoreo. No es así, sirven a audiencias distintas. El monitoreo es para tu equipo de ingeniería (métricas detalladas, alertas en Slack/email/WhatsApp). La página de estado es para tus clientes (vista simplificada, acceso público). Lo ideal es que los mismos health checks alimenten las dos cosas, así nunca se contradicen.

Preguntas frecuentes

¿Los clientes pueden ver métricas detalladas?

No deberían. La página pública tiene que mostrar una vista curada: estado del endpoint, porcentaje de uptime, línea de tiempo de 30 días y hora del último chequeo. Las métricas detalladas como latencia P95, tiempo de resolución DNS y duración del handshake TLS van en tu dashboard de monitoreo interno.

¿Con qué frecuencia se actualiza?

Debería reflejar siempre el resultado del último health check. Con chequeos automáticos cada 1 a 5 minutos, idealmente desde varias regiones, la página queda a minutos del tiempo real.

¿Puede ser gratis?

Sí. Varias herramientas de monitoreo de uptime incluyen una página de estado básica en su plan gratuito, y una página DIY en un hosting estático no cuesta más que tiempo de ingeniería. Los planes pagos suelen sumar dominio propio, branding y notificaciones a suscriptores.