ping

Endpoint de santé peu coûteux. Renvoie 200 avec un petit corps JSON lorsque la Function App est en ligne. Aucun en-tête d'authentification requis : utilisez-le pour vos sondes de disponibilité et vos smoke tests en CI.

Requête

Réponse

{
  "status": "ok",
  "service": "qr-branding",
  "version": "1.6.2",
  "now": "2026-05-24T08:14:31Z"
}

status : toujours "ok" lorsque la fonction s'exécute. Sinon, vous obtiendriez une erreur de connexion, pas un corps JSON.
version : version semver du moteur déployé.
now : horloge du serveur en UTC. Utile pour vérifier que votre signature X-Internal-Ts ne dérive pas.

Cas d'usage

Sonde de disponibilité : appelez /api/ping toutes les 60 s ; alertez sur toute réponse autre que 200.
Smoke test en CI : après chaque déploiement, faites échouer le pipeline si version ne correspond pas au tag que vous venez de pousser.
Contrôle du décalage d'horloge : comparez now à l'horloge de votre client pour déboguer un 401 INVALID_SIGNATURE du BFF interne (le TTL est de 60 s ; au-delà de 90 s de décalage, le HMAC échoue).

Ce qu'il ne vérifie PAS

Le ping est volontairement léger. Il ne valide pas :

Que la base de données est joignable.
Que les fournisseurs de LLM répondent.
Que vos en-têtes d'authentification RapidAPI / internes sont correctement configurés.

Pour des contrôles plus poussés, appelez /api/qr/generate avec une charge utile minimale (content seulement) et vérifiez que le QR revient bien.