Integrationen

Geräte und Sensoren übertragen

Minimalen, normalisierten Snapshot mit maximal 5.000 Einträgen senden.

Voraussetzungen

• Erfolgreicher /verify-Test
• Liste ausdrücklich ausgewählter Healthcheck-Elemente

Schritt für Schritt

1. Vergib stabile externalId-Werte.
2. Nutze pseudonyme, verständliche Namen.
3. Mappe Zustand auf online, offline, warning oder unknown.
4. Übertrage Batterie und lastSeenUtc nur wenn vorhanden.
5. Sende Full Snapshots periodisch; Änderungen dürfen zusätzlich sofort gesendet werden.

Beispielkonfiguration

{"apiVersion":"2026-08-01","siteId":"DEINE-STANDORT-GUID",
 "source":"iobroker","sentAtUtc":"2026-08-07T18:30:00Z","isFullSnapshot":true,
 "items":[{"externalId":"zigbee.0.sensor_bedroom","name":"Schlafzimmer Sensor",
 "type":"sensor","status":"online","batteryPercent":24,
 "lastSeenUtc":"2026-08-07T18:28:12Z","isCritical":false}]}

Testschritt

Sende den Snapshot zweimal mit derselben Idempotency-Key-Kennung und öffne Geräte & Entitäten.

Erwartetes Ergebnis

HTTP 202 mit processedItems. Das Element erscheint ohne Roh-Payload unter Geräte & Entitäten.

Fehlerbehebung

• duplicate_external_id: externalId im selben Snapshot eindeutig machen.
• invalid_item: Längen, Batteriebereich 0–100 und Pflichtfelder prüfen.

Sicherheitshinweise

• Keine Messwerte senden, die für Healthcheck nicht erforderlich sind.
• Namen ohne Personenbezug verwenden.