Zum Inhalt springen

GET /api/ping

Günstiger Health-Endpunkt. Gibt 200 mit einem kleinen JSON-Body zurück, wenn die Function App läuft. Kein Auth-Header nötig – nutze ihn für Uptime-Monitore und CI-Smoke-Tests.

Anfrage

Antwort

{
  "status": "ok",
  "service": "qr-branding",
  "version": "1.6.2",
  "now": "2026-05-24T08:14:31Z"
}
  • status – immer "ok", wenn die Funktion ausgeführt wird. Andernfalls bekämst du einen Verbindungsfehler, keinen JSON-Body.
  • version – Semver der bereitgestellten Engine.
  • now – Serveruhr in UTC. Nützlich, um zu prüfen, dass deine X-Internal-Ts-Signatur nicht abdriftet.

Anwendungsfälle

  • Uptime-Monitor: Ruf /api/ping alle 60 s auf; Alarm bei allem außer 200.
  • CI-Smoke-Test: Lass die Pipeline nach jedem Deploy fehlschlagen, wenn version nicht zum gerade gepushten Tag passt.
  • Uhrabweichung prüfen: Vergleiche now mit deiner Client-Uhr, wenn du 401 INVALID_SIGNATURE vom internen BFF debuggst (TTL ist 60 s; ab > 90 s Abweichung schlägt der HMAC fehl).

Was er NICHT prüft

Der Ping ist absichtlich günstig. Er prüft nicht:

  • Ob die Datenbank erreichbar ist.
  • Ob die LLM-Anbieter antworten.
  • Ob deine RapidAPI- bzw. internen Auth-Header korrekt konfiguriert sind.

Für tiefere Prüfungen ruf /api/qr/generate mit einem minimalen Payload (nur content) auf und prüfe, ob der QR-Code zurückkommt.