ping

Endpoint di stato leggero. Restituisce 200 con un piccolo corpo JSON quando la Function App è attiva. Nessun header di autenticazione richiesto: usalo per i monitor di uptime e gli smoke test della CI.

Richiesta

Risposta

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

status: sempre "ok" quando la funzione viene eseguita. Se non lo fosse, riceveresti un errore di connessione, non un corpo JSON.
version: versione semver del motore distribuito.
now: orologio del server in UTC. Utile per verificare che la tua firma X-Internal-Ts non stia andando fuori sincrono.

Casi d'uso

Monitor di uptime: chiama /api/ping ogni 60s; invia un avviso se la risposta non è 200.
Smoke test della CI: dopo ogni deploy, fai fallire la pipeline se version non corrisponde al tag che hai appena pubblicato.
Controllo dello sfasamento dell'orologio: confronta now con l'orologio del tuo client quando analizzi un 401 INVALID_SIGNATURE dal BFF interno (il TTL è 60s; uno sfasamento > 90s fa fallire l'HMAC).

Cosa NON controlla

Il ping è volutamente leggero. Non verifica:

Se il database è raggiungibile.
Se i provider LLM rispondono.
Se i tuoi header di autenticazione RapidAPI / interni sono configurati correttamente.

Per controlli più approfonditi, chiama /api/qr/generate con un payload minimo (solo content) e verifica che il QR venga restituito.