Datenlieferungen: Übersicht
Eine Datenlieferung 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ählpunkten empfangen.
- Route: Die Zuweisung eines Zählpunkts zu einer Verbindung. Ein Zählpunkt kann an mehrere Verbindungen gleichzeitig routen.
Datenlieferungstypen
| 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ählpunkt
Eine Verbindung kann Daten von beliebig vielen Zählpunkten empfangen, und die Anzahl der Verbindungen selbst ist nicht begrenzt. Begrenzt ist nur, an wie viele Verbindungen ein einzelner Zählpunkt gleichzeitig routet; das hängt vom Plan ab. Community hat keine Datenlieferungen — Daten holen Sie dort über die API ab.
| Plan | Routen pro Zählpunkt |
|---|---|
| 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 | Übertragung | 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.
Datenlieferungen vs. geplante Exporte
Datenlieferungen versorgen ein externes System laufend mit Messdaten, sobald sie ankommen. Ein geplanter Export ist etwas anderes: Er erstellt eine Zusammenfassung eines abgeschlossenen Zeitraums als CSV- oder XLSX-Datei 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.