Diagnose

Heartbeat testen

Payload lokal validieren und sichere Serverantworten auswerten.

Voraussetzungen

• Standort-ID, Quellname und aktiver API-Key
• Korrekte UTC-Systemzeit

Schritt für Schritt

1. Führe zuerst /verify aus.
2. Sende den Beispiel-Heartbeat mit aktueller sentAtUtc.
3. Verwende eine eindeutige Idempotency-Key-Kennung.
4. Prüfe die 202-Antwort und ‚Letzte Übertragung‘.

Beispielkonfiguration

curl -X POST https://www.homepulse.at/api/ingest/homeassistant/heartbeat \
  -H "Content-Type: application/json" \
  -H "X-HomePulse-Key: hp_live_DEIN_KEY" \
  -H "Idempotency-Key: manual-test-001" \
  -d '{"apiVersion":"2026-08-01","siteId":"DEINE-STANDORT-GUID","source":"homeassistant","sourceVersion":"2026.8","sentAtUtc":"2026-08-07T18:30:00Z","status":"online","uptimeSeconds":583920}'

Testschritt

Sende den Request mit aktueller sentAtUtc und wiederhole ihn danach mit derselben Idempotency-Key-Kennung.

Erwartetes Ergebnis

HTTP 202. Ein zweiter identischer Request liefert ebenfalls 202 mit duplicate=true und erzeugt keinen zweiten Datensatz.

Fehlerbehebung

• 400 invalid_sent_at: aktuelle UTC-Zeit einsetzen.
• 400 source_mismatch: Route und source müssen identisch sein.
• 413: Heartbeat ist auf 32 KiB begrenzt.

Sicherheitshinweise

• Shell-History bei echten Keys vermeiden oder Key über eine geschützte Environment-Variable einsetzen.