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
  1. Wählen Sie unter „APIs“ die Aktion „API hinzufügen“. Geben Sie der Schnittstelle einen Namen und wählen Sie „Lese-API“.
  2. 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 ansehen

Zugriff 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
  1. Öffnen Sie die API-Testumgebung. Wählen Sie einen Zeitraum mit Messdaten und begrenzen Sie den ersten Request auf wenige Ergebnisse.
  2. 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.
  3. Ö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.