Integrationen: Übersicht
Eine Integration ist ein push-basiertes Zustellziel: Sobald neue Messwerte eingehen, sendet energiedaten.at sie an das von Ihnen konfigurierte System. Sie müssen die Daten nicht aktiv abfragen.
Das Modell besteht aus zwei Ebenen:
- Verbindung: Das Zustellziel (eine URL, ein MQTT-Broker oder eine E-Mail-Adresse). Eine Verbindung kann Daten von mehreren Zählern empfangen.
- Route: Die Zuweisung eines Zählers zu einer Verbindung. Ein Zähler kann an mehrere Verbindungen gleichzeitig routen.
Integrationstypen
| Typ | Beschreibung | Verfügbar ab |
|---|---|---|
| Webhook | JSON-Push an eine URL bei neuen Daten | Light |
| MQTT | Pub/Sub-Messaging für IoT-Plattformen | Plus |
| E-Mail (CSV) | Geplanter CSV-Versand per E-Mail | Light |
| SFTP | Geplanter CSV-Upload auf einen Server | Pro |
Routen pro Zähler
Eine Verbindung kann Daten von beliebig vielen Zählern empfangen, und die Anzahl der Verbindungen selbst ist nicht begrenzt. Begrenzt ist nur, an wie viele Verbindungen ein einzelner Zähler gleichzeitig routet; das hängt vom Plan ab.
| Plan | Routen pro Zähler |
|---|---|
| Community | 0 (nur API-Zugriff) |
| Light | 1 |
| Plus | 2 |
| Pro | 5 |
Deaktivierung bei Zustellfehlern
Schlägt eine Zustellung 5-mal in Folge fehl, wird die Verbindung deaktiviert und Sie erhalten eine Benachrichtigung. Keine weiteren Zustellversuche laufen, bis Sie die Verbindung geprüft und wieder aktiviert haben. Verlauf und Fehlerdetails finden Sie unter Zustellprotokolle & Fehler.
Tools anbinden
Für verbreitete Tools gibt es fertige Anleitungen:
| Tool | Für wen | Integrationstyp | Mindestplan |
|---|---|---|---|
| Home Assistant | Smart-Home-Nutzer, Entwickler | HACS-Integration (API) | Community (kostenlos) |
| ThingsBoard | Energiedienstleister, Facility Manager | MQTT | Plus |
| EnerChart | Energieberater, Hausverwaltungen | MQTT oder E-Mail (CSV) | Light (CSV) / Plus (MQTT) |
API-Direktzugriff
Wenn Sie eigene Anwendungen bauen oder ein Tool anbinden möchten, das hier nicht aufgeführt ist, nutzen Sie die REST-API direkt:
- API-Schnelleinstieg: vom Token bis zum ersten Datenpunkt in 5 Minuten.
- API-Referenz: vollständige Endpunkt-Dokumentation.
Integrationen vs. geplante Exporte
Integrationen versorgen ein externes System laufend mit Zählerdaten, sobald sie ankommen. Ein geplanter Export ist etwas anderes: Er erstellt eine CSV-Zusammenfassung eines abgeschlossenen Zeitraums und verschickt sie per E-Mail, einmalig, auf Abruf oder nach Zeitplan. Brauchen Sie eine Momentaufnahme für Ablage oder Weitergabe, ist ein geplanter Export das richtige Werkzeug.
