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 firmaX-Internal-Tsno se desvía.
Casos de uso
- Monitor de disponibilidad: llama a
/api/pingcada 60 s y alerta ante cualquier respuesta distinta de 200. - Prueba de humo en CI: tras cada despliegue, haz fallar el pipeline si
versionno coincide con la etiqueta que acabas de publicar. - Comprobación de desfase de reloj: compara
nowcon el reloj de tu cliente al depurar un401 INVALID_SIGNATUREdel 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.