Auf dieser Seite
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 | Starter |
| MQTT | Pub/Sub-Messaging für IoT-Plattformen | Growing |
| E-Mail (CSV) | Geplanter CSV-Versand per E-Mail | Starter |
| SFTP | Geplanter CSV-Upload auf einen Server | Business |
Limits nach Plan
| Plan | Verbindungen |
|---|---|
| Community | 0 (nur API-Zugriff) |
| Starter | 2 |
| Growing | 5 |
| Business | Unbegrenzt |
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 | Growing |
| EnerChart | Energieberater, Hausverwaltungen | MQTT oder E-Mail (CSV) | Starter (CSV) / Growing (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. Berichte
Integrationen versorgen ein externes System laufend mit Zählerdaten, sobald sie ankommen. Ein Bericht 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 Bericht das richtige Werkzeug.