Integrationen
Geräte und Sensoren übertragen
Normalisierte Zustände, typisierte Werte und Einheiten mit maximal 5.000 Einträgen senden.
Voraussetzungen
- Erfolgreicher /verify-Test
- Liste ausdrücklich ausgewählter Healthcheck-Elemente
Schritt für Schritt
- Vergib stabile externalId-Werte.
- Nutze pseudonyme, verständliche Namen.
- Mappe Zustand auf online, offline, warning oder unknown.
- Übertrage einen Mess- oder Schaltwert als typisiertes JSON-Feld value und die Einheit getrennt als unit.
- Übertrage Batterie und lastSeenUtc nur wenn vorhanden.
- 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":"weather.outdoor_temperature","name":"Außentemperatur",
"type":"sensor","status":"online","value":24.6,"unit":"°C","batteryPercent":84,
"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 mit aktuellem Wert und Einheit unter Geräte & Entitäten und kann in eigenen Regeln gewählt werden.
Fehlerbehebung
- duplicate_external_id: externalId im selben Snapshot eindeutig machen.
- invalid_item: Längen, Batteriebereich 0–100 und Pflichtfelder prüfen.
- Falscher Datentyp: value als JSON-Zahl, -Text oder -Boolean senden; Zahlen nicht zusammen mit der Einheit in einen String schreiben.
- Kein aktueller Wert: Connector aktualisieren oder value und unit explizit ergänzen.
Sicherheitshinweise
- Keine Messwerte senden, die für Healthcheck nicht erforderlich sind.
- Namen ohne Personenbezug verwenden.