Zur Hausstationsübersicht
Hausstation in NAO · Kapitel 5 von 5
Hausstationsdaten per API bereitstellen
Stellen Sie einer Abrechnung, einem Portal oder einem anderen System gezielt die Hausstationsdaten bereit, die es braucht.
Lese-API einrichten und Daten auswählen
- Stammdaten
- Stationsname und Vertragsleistung in kW
- Messdaten
- Vorlauftemperaturen oder Zählerstände mit Zeitstempel
- Berechnungen
- Temperaturspreizung aus dem Benchmark
- Wählen Sie unter „APIs“ die Aktion „API hinzufügen“. Geben Sie der Schnittstelle einen Namen und wählen Sie „Lese-API“.
- Wählen Sie unter „Filter“ das Modell „Hausstation“. Grenzen Sie die Freigabe auf einen Arbeitsbereich oder einzelne Assets ein.
JSON-Felder unter „Key/Value“ konfigurieren
- stationsname
- Name des Assets als Text
- vorlauftemperaturen
- Letzter Messwert je 24 Stunden mit Zeitstempel und Einheit
- temperaturspreizung
- Höchster Wert des Benchmarks im Zeitraum in K
Wählen Sie für „temperaturspreizung“ das Rückgabeobjekt „Zeitreihen-Aggregierung“, die Datenpunktart „Berechnung“ und den Benchmark „Temperaturspreizung“. Mit „Maximaler Wert“ und dem Rückgabefeld „Wert“ liefert die API eine Zahl. Die Feldbeschreibung erscheint in der Dokumentation.
Formel für die Temperaturspreizung ansehenZugriff auf die freigegebenen Daten absichern
- Datenumfang
- Ausgewählte Assets und Rückgabefelder
- API-Key
- Authorization: Bearer <API-Key>
- Netzwerk
- Optional nur ausgewählte IP-Adressen zulassen
Hinterlegen Sie bei Bedarf die IP-Adressen des abrufenden Systems unter „Haupteigenschaften“. Speichern Sie die API und legen Sie den einmalig angezeigten Key im Secret-Speicher des Zielsystems ab. Senden Sie ihn über HTTPS im Authorization-Header. In der Testumgebung können Sie den Key bei Bedarf erneuern.
Request testen und ins Zielsystem übernehmen
- Request
- GET mit start, stop, filter, page und limit
- Ergebnisse
- JSON-Antwort direkt in NAO prüfen
- Dokumentation
- Parameter und Felder für Ihre API nachschlagen
- Öffnen Sie die API-Testumgebung. Wählen Sie einen Zeitraum mit Messdaten und begrenzen Sie den ersten Request auf wenige Ergebnisse.
- Klicken Sie auf „Request ausführen“. Die Demo-Messwerte ergeben 20 K bei 0,6 m³/h und 0 K an der Schwelle von 0,1 m³/h. Im Screenshot liefert die API für „temperaturspreizung“ noch null, da für das neue Demo-Asset kein Benchmark-Lauf gespeichert war.
- Öffnen Sie „Dokumentation“ für Parameter, Feldbeschreibungen und Datentypen. Nutzen Sie Endpunkt und cURL-Beispiel aus dem API-Key-Dialog, um den Abruf aus dem Zielsystem mit und ohne API-Key zu prüfen.





