Saltar al contenido

GET /api/ping

Endpoint de estado barato. Devuelve 200 con un JSON mínimo cuando la Function App está en marcha. No requiere cabecera de autenticación: úsalo para monitores de disponibilidad y pruebas de humo en CI.

Petición

Respuesta

{
  "status": "ok",
  "service": "qr-branding",
  "version": "1.6.2",
  "now": "2026-05-24T08:14:31Z"
}
  • status: siempre "ok" cuando la función se ejecuta. Si no se ejecutara, recibirías un error de conexión, no un cuerpo JSON.
  • version: versión semver del motor desplegado.
  • now: reloj del servidor en UTC. Sirve para comprobar que tu firma X-Internal-Ts no se desvía.

Casos de uso

  • Monitor de disponibilidad: llama a /api/ping cada 60 s y alerta ante cualquier respuesta distinta de 200.
  • Prueba de humo en CI: tras cada despliegue, haz fallar el pipeline si version no coincide con la etiqueta que acabas de publicar.
  • Comprobación de desfase de reloj: compara now con el reloj de tu cliente al depurar un 401 INVALID_SIGNATURE del BFF interno (el TTL es de 60 s; un desfase de más de 90 s hace fallar el HMAC).

Lo que NO comprueba

El ping es barato a propósito. No valida:

  • Si la base de datos es accesible.
  • Si los proveedores de LLM responden.
  • Si tus cabeceras de autenticación de RapidAPI o internas están bien configuradas.

Para comprobaciones más profundas, llama a /api/qr/generate con un cuerpo mínimo (solo content) y verifica que vuelve el QR.