{"id":1858,"date":"2023-01-16T17:13:54","date_gmt":"2023-01-16T16:13:54","guid":{"rendered":"https:\/\/www.rustimation.eu\/?p=1858"},"modified":"2025-07-25T08:18:20","modified_gmt":"2025-07-25T06:18:20","slug":"vicare-daten-abfragen","status":"publish","type":"post","link":"https:\/\/www.rustimation.eu\/index.php\/vicare-daten-abfragen\/","title":{"rendered":"Viessmann API und Node-Red – Teil 3 – Daten abfragen"},"content":{"rendered":"

Dies ist das dritte Kapitel meiner Reihe \u00fcber die Nutzung der Viessmann API mit Node-Red. Einen Einstieg bekommst du am ehesten, indem du mit dem Kapitel 1 \u2013 Die Viessmann API und Node-Red \u00dcberblick<\/a> anf\u00e4ngst.<\/p>\n

\u00c4nderungen per\u00a0 Februar 2025<\/h3>\n

Die Viessmann API ist immer noch \"work in Progress\". Demzufolge \u00e4ndert sich hin und wieder etwas. Angek\u00fcndigt werden \u00c4nderungen im Change Log<\/a>.<\/p>\n

Diverse Features – vor allem f\u00fcr W\u00e4rmepumpen und Brennstoffzellen – bekommen per Februar 2025 eine neue Bezeichnung. Welche das sind, steht im Change Log.<\/p>\n

F\u00fcr alle wichtig ist die \u00c4nderung des Feature Endpoints von v1 auf v2. Stand Juli 2025 funktioniert zwar alles noch wie gehabt mit v1 aber es schadet sicher nicht, den Endpoint entsprechend umzuschreiben. Aus<\/p>\n

https:\/\/api.viessmann-climatesolutions.com\/iot\/v1\/features\/installations\/{{installationID}}\/gateways\/{{gatewaySerial}}\/devices\/{{deviceId}}\/features\/<\/pre>\n
wird jetzt<\/p>\n
https:\/\/api.viessmann-climatesolutions.com\/iot\/v2\/features\/installations\/{{installationID}}\/gateways\/{{gatewaySerial}}\/devices\/{{deviceId}}\/features\/<\/pre>\n
Die nachfolgenden Node-Red flows sind entsprechend aktualisiert.<\/p>\n
Autorisierung des Requests
\n<\/strong><\/h3>\n
Alle f\u00fcr die Autorisierung eines beliebigen Requests n\u00f6tigen Informationen befinden sich in meinem \"Universal Header Node\", einem Funktionsnode, der den http Request Node entsprechend f\u00fcr die Abfrage der API best\u00fcckt. Der Funktionsnode sieht wie folgt aus und muss nicht individuell angepasst werden.<\/p>\n
<\/p>\n
var atoken = flow.get('accessToken')\r\nmsg.headers = {\r\n    Authorization: \"Bearer \"+ atoken\r\n}\r\nmsg.installationID = flow.get('installationID');\r\nmsg.gatewaySerial = flow.get('gatewaySerial');\r\nmsg.deviceId = flow.get('deviceID');\r\nreturn msg;<\/pre>\n
Das alles setzt voraus, dass die entsprechenden Flow Variablen wie im vorigen Kapitel<\/a> gesetzt wurden.<\/p>\n
In diesem Beispiel sind alle Viessmann Komponenten auf einem Node-Red Tab versammelt; daher werden weitgehend Flow Variable verwendet. F\u00fcr den Fall, dass die Logik auf mehrere Flows verteilt ist, sind ensprechend Global Variablen zu verwenden.<\/span><\/p>\n
Feature \u00dcberblick<\/h3>\n
Die Feature Abfrage liefert dir auf einen Schlag alle Parameter, welche deine Anlage bei dem von dir gebuchten Paket zur Verf\u00fcgung stellt. Die \u00fcbermittelte Liste (ein gro\u00dfes JSON Objekt) ist f\u00fcr jede Installation unterschiedlich. Sie ist hilfreich, um sich die Parameter herauszusuchen, die einen interessieren. Die Datenpunkte sind im Developer Bereich von Viessmann<\/a> erkl\u00e4rt.<\/p>\n
Die Abfrage erfolgt wie folgt:<\/p>\n
\"\"<\/a><\/p>\n
Der http Request sieht so aus:<\/p>\n
\"\"<\/a><\/p>\n
Zur besseren Lesbarkeit noch die URL Zeile als JS Code:<\/p>\n
https:\/\/api.viessmann-climatesolutions.com\/iot\/v2\/features\/installations\/{{installationID}}\/gateways\/{{gatewaySerial}}\/devices\/{{deviceId}}\/features\/<\/pre>\n
Auch diese Zeile muss nicht angepasst werden. Die im Universal Heade Node davor gesetzten Werte stecken in den doppelten geschweiften Klammern (double moustaches).<\/p>\n
Seit Februar 2023 gibt es eine etwas andere API Syntax bei der Feature Abfrage, bzw. einen neuen Endpunkt \"features\", der den bisherigen Endunkt \"equipment\" ersetzt.
\n<\/span>https:\/\/api.viessmann-climatesolutions.com\/iot\/v2\/features\/installations…<\/span>\u00a0<\/span>Die Anleitung hier ist auf die neuen Verh\u00e4ltnisse angepasst.<\/span><\/p>\n
Nach dem Triggern erscheint – wenn alles funktioniert wie gew\u00fcnscht – im Debug Node ein Objekt, das wir durch Anklicken der kleinen Dreiecke analysieren k\u00f6nnen. Unsere Features stecken in der Payload, bei mir sind das immerhin 110 verschiedene Parameter.<\/p>\n
Das Debug Fenster erreicht man \u00fcber das Anklicken des K\u00e4fersymbols oben rechts.<\/p>\n
\"\"
Achtung: die neue URL lautet viessmann-climatesolutions.com<\/figcaption><\/figure>\n
Zum Ansehen eines JSON Objekts gibt es mehrere M\u00f6glichkeiten. Entweder einen Online JSON Viewer, oder mit Firefox indem man das abgespeicherte JSON File l\u00e4dt oder mit Notepad++ und einem JSON Viewer Plugin und sicher noch eine Menge anderer M\u00f6glichkeiten. Einfach den \"Werte kopieren\" Button oben rechts im Debugfenster anklicken und dann in das gew\u00fcnschte Dokument pasten.<\/p>\n
Der Vollst\u00e4ndigkeit halber noch der JSON Flow:<\/p>\n
[{\"id\":\"c7bf0b120ed79afe\",\"type\":\"tab\",\"label\":\"Flow 1\",\"disabled\":false,\"info\":\"\",\"env\":[]},{\"id\":\"52cc82fc16871334\",\"type\":\"inject\",\"z\":\"c7bf0b120ed79afe\",\"name\":\"Trigger\",\"props\":[{\"p\":\"payload\"},{\"p\":\"topic\",\"vt\":\"str\"}],\"repeat\":\"\",\"crontab\":\"\",\"once\":false,\"onceDelay\":\"2\",\"topic\":\"\",\"payload\":\"\",\"payloadType\":\"date\",\"x\":210,\"y\":80,\"wires\":[[\"67486be1a7671f13\"]]},{\"id\":\"57b1621ab4d7d311\",\"type\":\"http request\",\"z\":\"c7bf0b120ed79afe\",\"name\":\"Read Events\",\"method\":\"GET\",\"ret\":\"obj\",\"paytoqs\":\"ignore\",\"url\":\"https:\/\/api.viessmann-climatesolutions.com\/iot\/v2\/events-history\/installations\/{{installationID}}\/events?gatewaySerial={{gatewaySerial}}\",\"tls\":\"\",\"persist\":false,\"proxy\":\"\",\"insecureHTTPParser\":false,\"authType\":\"\",\"senderr\":false,\"headers\":[],\"x\":570,\"y\":80,\"wires\":[[\"cd6d356cea0a5307\"]]},{\"id\":\"cd6d356cea0a5307\",\"type\":\"debug\",\"z\":\"c7bf0b120ed79afe\",\"name\":\"Feature Array\",\"active\":true,\"tosidebar\":true,\"console\":false,\"tostatus\":false,\"complete\":\"payload\",\"targetType\":\"msg\",\"statusVal\":\"\",\"statusType\":\"auto\",\"x\":780,\"y\":80,\"wires\":[]},{\"id\":\"67486be1a7671f13\",\"type\":\"function\",\"z\":\"c7bf0b120ed79afe\",\"name\":\"Header\",\"func\":\"var atoken = flow.get('accessToken')\\nmsg.headers = {}\\nmsg.headers = {\\n    Authorization: \\\"Bearer \\\" + atoken\\n}\\nmsg.installationID = flow.get('installationID');\\nmsg.gatewaySerial = flow.get('gatewaySerial');\\n\/\/msg.deviceId = flow.get('deviceID');\\n\/\/msg.headers['Content-Type'] = 'application\/json';\\nreturn msg;\\n\\n\",\"outputs\":1,\"noerr\":0,\"initialize\":\"\",\"finalize\":\"\",\"libs\":[],\"x\":380,\"y\":80,\"wires\":[[\"57b1621ab4d7d311\"]]}]<\/pre>\n
Nur wenige Datenpunkte auslesen<\/h3>\n
Wie du wahrscheinlich wei\u00dft, gibt es eine Begrenzung von 1440 Zugriffen innerhalb 24 Stunden. Wenn dich nur wenige Datenpunkte interessieren und diese auch nicht all zu oft abfragen willst, dann ist der direkte Featurezugriff \u00fcber die URL am einfachsten.<\/p>\n
Probieren wir das einfach mit dem Wert \"Au\u00dfentemperatur\" – im JSON steht das unter heating.boiler.sensors.temperature.commonSupply<\/em>.<\/p>\n
\"\"<\/a><\/p>\n
Die URL Zeile im Read Feature http Request Node sieht wie folgt aus:<\/p>\n
https:\/\/api.viessmann-climatesolutions.com\/iot\/v2\/features\/installations\/{{installationID}}\/gateways\/{{gatewaySerial}}\/devices\/{{deviceId}}\/features\/heating.sensors.temperature.outside<\/span><\/p>\n
Die API liefert uns ein kleines JSON Objekt, aus dem wir den Datenpunkt ganz leicht extrahieren k\u00f6nnen. Der Extract Value Node sieht so aus:<\/p>\n
msg.payload=msg.payload.data.properties.value.value; \r\nmsg.topic=\"Common Supply\"; \r\nreturn msg;<\/pre>\n
msg.topic ist nicht unbedingt erforderlich, hilft aber, wenn man ein Chart mit mehreren Kurven baut.<\/p>\n
Hier der JSON Flow dazu:<\/p>\n
[{\"id\":\"28aac96cd4c85e2f\",\"type\":\"inject\",\"z\":\"640d4a161fb8fa28\",\"name\":\"\",\"props\":[{\"p\":\"payload\"},{\"p\":\"topic\",\"vt\":\"str\"}],\"repeat\":\"\",\"crontab\":\"\",\"once\":false,\"onceDelay\":\"5\",\"topic\":\"\",\"payload\":\"true\",\"payloadType\":\"bool\",\"x\":110,\"y\":1600,\"wires\":[[\"8e3997f78f283787\"]]},{\"id\":\"8e3997f78f283787\",\"type\":\"function\",\"z\":\"640d4a161fb8fa28\",\"name\":\"Universal Header\",\"func\":\"let atoken = flow.get('accessToken')\\nmsg.headers = {\\n    Authorization: \\\"Bearer \\\"+ atoken\\n}\\nmsg.installationID = flow.get('installationID');\\nmsg.gatewaySerial = flow.get('gatewaySerial');\\nmsg.deviceId = flow.get('deviceID');\\nreturn msg;\\n\\n\",\"outputs\":1,\"timeout\":\"\",\"noerr\":0,\"initialize\":\"\",\"finalize\":\"\",\"libs\":[],\"x\":290,\"y\":1600,\"wires\":[[\"70ab63bf7d6ee874\"]]},{\"id\":\"70ab63bf7d6ee874\",\"type\":\"http request\",\"z\":\"640d4a161fb8fa28\",\"name\":\"Features auslesen\",\"method\":\"GET\",\"ret\":\"obj\",\"paytoqs\":\"ignore\",\"url\":\"https:\/\/api.viessmann-climatesolutions.com\/iot\/v2\/features\/installations\/{{installationID}}\/gateways\/{{gatewaySerial}}\/devices\/{{deviceId}}\/features\/heating.sensors.temperature.outside\",\"tls\":\"\",\"persist\":false,\"proxy\":\"\",\"insecureHTTPParser\":false,\"authType\":\"\",\"senderr\":false,\"headers\":[],\"x\":530,\"y\":1600,\"wires\":[[\"0ca0940e969244cb\",\"aaa746ddc0a33e00\"]]},{\"id\":\"aaa746ddc0a33e00\",\"type\":\"debug\",\"z\":\"640d4a161fb8fa28\",\"name\":\"debug 13\",\"active\":true,\"tosidebar\":true,\"console\":false,\"tostatus\":false,\"complete\":\"false\",\"statusVal\":\"\",\"statusType\":\"auto\",\"x\":640,\"y\":1460,\"wires\":[]}]<\/pre>\n
W\u00fcrdest du diesen Flow jede Minute aufrufen, w\u00e4ren alle 1440 Zugriffe\/Tag\u00a0 verbraucht. In so fern ist das Abfragen weniger einzelner Datenpunkte nur bei geringer Abfragefrequenz sinnvoll.<\/p>\n
\u00dcbrigens: Auch wenn alle Zugriffe verbraucht sind, kannst du immer noch mit der App auf deine Heizung zugreifen.<\/span><\/p>\n
Mehr Datenpunkte \u00f6fter auslesen<\/h3>\n
Da der gro\u00dfe \"Feature Request\" von weiter oben ja alle Datenpunkte inklusive deren Werte auf einmal ausliest, k\u00f6nnen wir das Ergebnis dieses Requests relativ leicht in einzelne Werte aufdr\u00f6seln.<\/p>\n
Man k\u00f6nnte sich hier einfach an der Position des gesuchten Datenpunkts im Array orientieren. Nehmen wir an, die Au\u00dfentemperatur ist der 65. Wert in der Feature Overview Tabelle, dann k\u00f6nnen wir diesen Wert per Javacript ganz einfach extrahieren:<\/p>\n
msg.payload=msg.payload.data[65].properties.value.value;<\/pre>\n
Das klingt zwar ganz einfach, hat aber Nachteile: Viessmann wird die Reihenfolge beliebig \u00e4ndern, wenn neue Features hinzukommen oder wegfallen. Der Datenpunkt ist also nicht immer an 65. Stelle. Auch wird sich die Position des Datenpunkts von Installation zu Installation unterscheiden.<\/p>\n
Um die uns interessierenden Datenpunkte zu extrahieren, m\u00fcssen wir das JSON Feature Objekt nach dem richtigen Namen durchforsten d.h. parsen.<\/p>\n
Das geschieht \u00fcber die Javascript findindex<\/em> Methode:<\/p>\n
var  featureArray=msg.payload.data;\r\nvar idx = featureArray.findIndex( (element) => element.feature === 'heating.sensors.temperature.outside');\r\nmsg.payload=msg.payload.data[idx].properties.value.value;\r\nreturn msg;<\/pre>\n
\"\"<\/a><\/p>\n
Auf diese Weise lassen sich quasi beliebig viele Datenpunkte auswerten, ohne das Abrufkontingent zu \u00fcberlasten. Bei meiner Implementation frage ich alle 90 Sekunden nach den Werten. So habe ich immer noch genug Reserve f\u00fcr andere Abfragen oder Einstellungen.<\/p>\n
Visualisieren<\/h3>\n
Will man sich lediglich den aktuellen Wert in Textform anzeigen lassen, dann reicht der Dashboard Text Node<\/em> aus.<\/p>\n
\"\"<\/a><\/p>\n
Eine h\u00fcbschere Darstellung bekommen wir, wenn wir den Dashboard Gauge Node.<\/em> verwenden. F\u00fcr die Darstellung von Prozentwerten ist das Donut Gauge<\/em> sehr nett anzusehen. F\u00fcllst\u00e4nde mit dem Level Gauge<\/em>.<\/p>\n
\"\" \"\" \"\"<\/p>\n
Schaltzust\u00e4nde z.B. Brenner an\/aus lassen sich ganz einfach durch umfunktionierte Dashboard Switch Nodes<\/em> darstellen.\"\"\"\"<\/a>Hier l\u00e4sst sich auch das Standard Icon gegen eine Reihe anderer, auch animierter Symbole austauschen. Obiges Flammensymbol l\u00e4sst sich einstellen, indem der Switch Mode wie folgt konfiguriert wird:<\/p>\n
\"\"<\/a><\/p>\n
Mehr \u00fcber die Verwendung von Font Awesome<\/a> und Material Design Icons im Kapitel \"Node-Red Dashboard Tips & Tricks<\/a>\".<\/p>\n
Liniendiagramme<\/h3>\n
Werte im Zeitverlauf kann man sehr sch\u00f6n mit mit dem Dashboard Chart Node darstellen.<\/p>\n
Hierzu einfach den Output Node mit dem Chart Node verbinden. Bei Gruppe<\/em> einen entsprechenden \u00dcberbegriff eintragen, ggf. dahinter (Bleistiftsymbol) noch das passende Tab ausw\u00e4hlen. Hier einfach mal ein bisschen spielen…<\/p>\n
\"\"<\/p>\n
Wenn man bei Y-Achse nichts eintr\u00e4gt, passt Node-Red die Achse\u00a0 automatisch an.<\/p>\n
Will man mehrere Linien in einem Diagram darstellen, dann sollte jeder Output unbedingt sein eigenes Topic haben. Dieses Topic stellt dann auch die Legende im Chart dar.<\/p>\n
Die Farben kann man im Chart Node ausw\u00e4hlen, wobei der zuerst ankommende Wert immer die Farbe oben links bekommt, der zweite die rechts daneben, der vierte den linken Farbwert der zweiten Zeile und so fort. Ich habe bislang keine M\u00f6glichkeit gefunden, die Farbe direkt festzulegen.<\/p>\n
Ich behelfe mir hierbei mit dem Delay Node<\/em>, der sicherstellt, dass bei nahezu gleichzeitig eintreffenden Werten, der erste direkt durchgelassen, der zweite etwas, der dritte mehr und der vierte Wert lange verz\u00f6gert wird. \"\"<\/p>\n
Die Dauer der Aufzeichnung kann ebenfalls im Charte Node Eigenschaftsfenster unter X-Achse festgelegt werden. \u00c4ltere Werte fallen dann hinten runter und werden nicht gespeichert. Ebenso vergisst Node-Red alle Werte, wenn es neu gestartet wird.<\/p>\n
Will man das verhindern, m\u00fcssen die Werte phyikalisch weggeschrieben werden. Am besten in eine Datenbank, wobei sich hier die InfluxDB anbietet, welche f\u00fcr genau diesen Zweck geschaffen wurde. Hierf\u00fcr gibt es bei Node-Red bereits entsprechende Schreibe- und Lesenodes. Leider ist das Auslesen und Darstellen in Node-Red etwas kompiziert, aber das erkl\u00e4re ich in im Kapitel \u00fcber die\u00a0Influx DB<\/a><\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
Abfragen der Heizungsparameter von Viessmann Heizungen mit Hilfe von Node-Red. Kurzer Ausblick auf die Visualisierungsm\u00f6glichkeiten mit dem Node-Red Dashboard.<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[53,151,159],"tags":[169,170],"class_list":["post-1858","post","type-post","status-publish","format-standard","hentry","category-iot","category-node-red","category-viessmann-api","tag-daten-abfragen","tag-visualisieren"],"_links":{"self":[{"href":"https:\/\/www.rustimation.eu\/index.php\/wp-json\/wp\/v2\/posts\/1858","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.rustimation.eu\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.rustimation.eu\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.rustimation.eu\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.rustimation.eu\/index.php\/wp-json\/wp\/v2\/comments?post=1858"}],"version-history":[{"count":1,"href":"https:\/\/www.rustimation.eu\/index.php\/wp-json\/wp\/v2\/posts\/1858\/revisions"}],"predecessor-version":[{"id":3634,"href":"https:\/\/www.rustimation.eu\/index.php\/wp-json\/wp\/v2\/posts\/1858\/revisions\/3634"}],"wp:attachment":[{"href":"https:\/\/www.rustimation.eu\/index.php\/wp-json\/wp\/v2\/media?parent=1858"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.rustimation.eu\/index.php\/wp-json\/wp\/v2\/categories?post=1858"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.rustimation.eu\/index.php\/wp-json\/wp\/v2\/tags?post=1858"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}