Tu API es la columna vertebral de tu producto. Cuando se cae — o se ralentiza — tus clientes lo sienten. Pero la mayoría de los equipos manejan las caídas de forma reactiva: los usuarios se quejan, alguien revisa los logs, y 30 minutos después publican una respuesta. Una página de estado pública invierte esta dinámica. Permite que tus clientes verifiquen la salud de la API por sí mismos, en tiempo real, sin abrir un ticket.

En este tutorial, aprenderás qué hace que una página de estado sea buena, cómo crear una gratis con Nurbak, y cómo incrustar badges de uptime directamente en tu documentación.

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

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 confianza — cuando los clientes pueden ver los datos de uptime por sí mismos, confían más en tu servicio.
  • Menos tickets de soporte — durante 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ápida — en lugar de escribir respuestas individuales, actualizas una sola página que llega a todos los usuarios afectados.
  • Ventaja competitiva — muchas APIs aún 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

Puedes construirla tú mismo o usar una solución hospedada. El enfoque DIY te da control total sobre el diseño, pero debes construir y mantener la lógica de monitoreo, y si tu infraestructura cae, tu página de estado también cae. Una solución hospedada como Nurbak está lista en minutos, corre en infraestructura independiente, e incluye monitoreo automático — 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 endpoint — muestra la salud de cada endpoint individual, no solo un agregado.
  • Línea de tiempo de uptime — una visualización de 30 días que muestra cuándo cada endpoint estuvo activo, degradado o caído.
  • Porcentaje de uptime general — un número claro (ej: 99.97%) que resume la fiabilidad en un período.
  • Hora del último chequeo — un timestamp que demuestra que los datos son frescos.

Cómo Nurbak ofrece páginas de estado públicas gratuitas

Nurbak incluye una página de estado pública para cada proyecto — en todos los planes, incluido el gratuito.

Paso 1: Crea un proyecto y añade endpoints

Regístrate y crea un proyecto. Añade los endpoints que quieras monitorear. Nurbak comienza a ejecutar health checks inmediatamente desde múltiples regiones globales.

Paso 2: Habilita la página de estado pública

En la configuración del proyecto, activa la página de estado pública. Nurbak genera una URL única y compartible:

https://app.nurbak.com/status/:token

Cualquier persona con la URL puede ver la página — no se requiere autenticación.

Paso 3: Elige qué mostrar

Controlas 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: Comparte 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, Nurbak proporciona badges SVG de uptime embebibles — similares a los badges de build que ves en los READMEs de GitHub.

Cada badge está disponible en:

https://app.nurbak.com/badge/:id.svg

El badge tiene código de colores: verde (activo), amarillo (latencia elevada), rojo (caído). Se cachean por 5 minutos. Incústalos 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 diferentes audiencias. 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). Con Nurbak, obtienes ambos en una sola herramienta.

Preguntas frecuentes

¿Los clientes pueden ver métricas detalladas?

No. La página pública muestra 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 solo son visibles para los propietarios del proyecto.

¿Con qué frecuencia se actualiza?

La página siempre refleja el resultado del último health check. Los chequeos se ejecutan cada 1 a 5 minutos dependiendo de tu plan, desde múltiples regiones globales.

¿Es gratuita?

Sí. Las páginas de estado públicas están incluidas en todos los planes de Nurbak, incluido el gratuito. No hay límite de visitantes ni costo adicional por los badges embebibles.

Crea tu página de estado gratis — sin tarjeta de crédito.