Climate Solutions Community

Hallo @MartinBruening , die Möglichkeiten des Heizstabs via ViCare App als auch über API sind aktuell nur auf lesende Funktionen beschränkt. Was genau würdest du am Heizstab steuern wollen? Gruß, Michael ... Mehr anzeigen

Hi @Frostboiler , es freut mich, dass du dich im API-Bereich des Forums meldest! Aller Anfang ist schwer 🙂 Gerne gehe ich auf die einzelnen Fragen von dir ein. Die Topologie für die IoT-Daten in der API sieht folgendermaßen aus: Installation >> Gateway >> Device. Innerhalb der Informationen zum Gateway wirst wahrscheinlich mehrere Devices mit jeweils einer ID finden. Devices müssen dabei nicht immer phsysisch sein, es kann sich auch um virtuelle Devices handeln. Die ID "RoomControl-1" beispielsweise ist ein virtuelles Device, worüber man die IoT-Daten zur Raumsteuerung abrufen kann. Das ist besonders relevant, wenn man eine sogenannte Einzelraumsteuerung im Haus hat, also Heizkörpert- und Fußbodenthermostate oder Klimasensoren. Die DeviceID "0" ist in der Regel der Wärmeerzeuger (Wärmepumpe, Gasheizung, ...). Das ist wahrscheinlich das wichtigste Device, weil hier die meisten IoT-Daten zum Heizsystem vorliegen. Nutze daher die DeviceID "0" um auf die wichtigen Daten deines Systems zuzugreifen. Einen Access Token zu erhalten kann am Anfang ziemlich tricky sein. Vielleicht hilft dir aber unsere Beispielcollection in Postman weiter. Hier sind die wichtigsten API-Befehle bereits aufgelistet. Zusammen mit der API Dokumentation sollte es hoffentlich klappen, einen Access Token zu generieren. Hier aber noch zwei Hinweise: Nutze für den ersten Schritt einen Web-Browser, um den API-Befehl auszuführen. Einfach die vollständige URL in die Adresszeile des Browsers eingeben und bei der anschließenden sich öffnenden Seite anmelden. Du wirst einen Code in der Adresszeile der neuen Seite sehen, die sich nach dem Login öffnet. Der Code aus Schritt eins ist nur 20 Sekunden lang gültig. Das heißt, nachdem der Code erstellt wurde, muss dieser innerhalb von 20 Sekunden im zweiten Schritt der Authorisierung verwendet werden. War die erfolgreich, solltest du aber anschließend sofort deinen Access Token bekommen. Bei den Fehlermeldungen, die du erhältst, könntest du mir dazu die entsprechenden API-Befehle nennen, die du ausführst? Das hilft, dir genauer sagen zu können, was der Fehler sein könnte. Leider kann ich dir nicht mit einem fertigen PHP-Skript weiterhelfen. Vielleicht findet sich aber hier in der Community jemand, der eine entsprechende Vorlage mit dir teilen kann. Gruß, Michael ... Mehr anzeigen

Hi @gecko1, nach einer ersten Überprüfung kam die Frage auf, wo genau der API Aufruf durchgeführt wird? Wird der Call im Browser durchgeführt? Das könnte nämlich die Erklärung für den Error "Client does not exist" sein. Versuche bitte einmal, die API über beispielsweise Postman aufzurufen. Du findest eine Beispiel Collection mit den wichtigsten Aufrufen der Viessmann API hier. Sag mir gerne, ob das bei dir klappt! Gruß, Michael ... Mehr anzeigen

Hi @Al-freddo , nach einer ersten Überprüfung kam die Frage auf, wo genau der API Aufruf durchgeführt wird? Wird der Call https://api.viessmann.com/iot/v2/features/installations/xxxxxx/gateways/yyyyyy/devices/0/features im Browser durchgeführt? Das könnte nämlich die Erklärung für den Error "Client does not exist" sein. Versuche bitte einmal, die API über beispielsweise Postman aufzurufen. Du findest eine Beispiel Collection mit den wichtigsten Aufrufen der Viessmann API hier. Sag mir gerne, ob das bei dir klappt! Gruß, Michael ... Mehr anzeigen

Danke für die weiteren Infos. Die DeviceID ist tatsächlich "0". Dein Fehler scheint hier aber ein anderer zu sein. Laut Error Message "Client does not exist" scheint etwas mit deinem API Key nicht zu stimmen. Bitte schick mir einmal deinen API Key (deine Client ID) und am besten die gatewaySerial per PN zu. Wir schauen uns das dann genauer an. Gruß, Michael ... Mehr anzeigen

@gecko1 was genau meinst du mit Anlage registrieren? Deinem vorherigen Beitrag zufolge hast du die Anlage bereits in ViCare. Damit solltest du auch in der Lage sein, Daten via API abzurufen. Funktioniert hierbei etwas nicht? Lass es mich gerne wissen! Gruß, Michael ... Mehr anzeigen

@Al-freddo könntest du mir (per PN) deinen Account Namen zuschicken und die ID vom Client, den du verwendest? Dann schauen wir uns das genauer an. Gruß, Michael ... Mehr anzeigen

Hallo @gecko1 , willkommen hier im Forum! Zu deiner ersten Frage: Generelle Infos zur API findest du in unserer API Dokumentation. Dort findest du die Sektion "IoT". Die IDs erhältst du, indem du folgenden API Befehl ausführst: https://api.viessmann.com/iot/v1/equipment/installations?includeGateways=true Dort findest du die Parameter "id" (unter "data") = InstallationID, "serial" (unter "data" > "gateways") = gatewaySerial, "id" (unter "data" > "gateways" > "devices") = DeviceID Du kannst auch unsere Postman Collection nutzen um die API zu testen. Bei den Fragen zu Templates für Grafana habe ich leider nichts, was ich teilen könnte. Vielleicht findet sich aber jemand in der Community, der dir dazu etwas bereitstellen kann 🙂 ... Mehr anzeigen

@CaCicala das Device mit der ID "0" ist ,wie du bereits sagst, das relevanteste Gerät. In der Regel steckt dort der Wärmeerzeuger samt dazugehörigen Features zum Abrufen. Das Device "gateway" müsste deine physische Vitoconnect sein. Allerdings stecken hier keine Features, die abgerufen werden können. Die nächsten beiden Devices sind nicht physisch, sondern nur virtuell als Software vorhanden. Leider habe ich keine Infos zu "HeatDemandControl". Das (virtuelle) Device "RoomControl-1" steht für eine mögliche Einzelraumsteuerung. Hierin enthalten sind Features auf Raumebene, um beispielsweise die Zieltemperatur eines Raumes zu steuern. Um mit diesem Device arbeiten zu können, muss jedoch eine Einzelraumsteuerung aktiv sein. Gruß, Michael ... Mehr anzeigen

Hi @CaCicala , du hast Recht, dass mann jeden Wärmeerzeuger mit seinem Gateway ansprechen muss. Das würde konkret heißen, dass ich bei einer Installation mit zwei Gateway auch zwei API Calls benötige (jeweils mit der entsprechenden Gateway Seriennummer), um die gesamten Daten abzurufen. In der Liste der verfügbaren Features in der API Dokumentation befinden sich vier Features, die mit PV (Suche nach "photovoltaic") zusammenhängen. Alle vier Features benötigen eines der beiden zusätzlichen Pakete. Wenn man ganz normal alle Daten des Geräts abruft, d.h. ohne ein spezielles Feature anzugeben, würde man auch keine Fehlermeldung erhalten. Welche Meldung kommt, wenn man versucht, explizit eines der nicht gebuchten Features abzufragen, weiß ich Ad-hoc nicht, lässt aber sicher mit einem kurzen Test herausfinden 🙂 Gruß, Michael ... Mehr anzeigen

Danke für die Hinweise @ghNeandr ! Die fehlenden Informationen zu den bufferCylinder Features haben wir ergänzt. Die Features zu compressors findest du, indem du anstelle der 0 ein N schreibst, also z.B. heating.compressors.N. Das N ist in der Dokumentation eine Variable (0, 1, 2, ...), da es mehrere compressors geben kann. Gruß, Michael   ... Mehr anzeigen

Hi @ghNeandr , Danke für den Hinweis, dass einige Features in der Dokumentation fehlen. Könntest du die Features hier einmal auflisten? Dann können wir die mit den Features Liste ergänzen. Abgesehen davon, benötigst du weitere Informationen zu den einzelnen Features? Gruß, Michael ... Mehr anzeigen

Hallo @ghNeandr , ich kann leider nicht nachvollziehen, warum dir "Gateway not found" als Fehlermeldung angezeigt wird. Aber normalerweise sollten die Features für die PV-Anlage über das gleiceh Gateway wie die Wärmepumpe abrufbar sein. Abgesehen davon kommt es aber auch darauf an, welches Paket der API du verwendest. In der API Dokumentation wird dir angezeigt, welches Paket für welches Feature benötigt wird. Mehr Infos zu den Paketen findest du hier. Ich hoffe, das hilft dir weiter. Gruß, Michael ... Mehr anzeigen

Hi @BlueTang , this feature is currently available if you have subscribed to the Advanced package of our. In the overview of data points the API documentation, this feature has the label "Advanced".  You can find more information about our packages here. I hope this helps. Regards, Michael ... Mehr anzeigen

@Hafenstrand danke für das Teilen der Seriennummern! Ich konnte einen ersten Blick auf die Anlagen werfen. Beide Anlagen sollten das gleiche Set an Features bereitstellen. Für welchen Heizkreis fragst du die Betriebsprogramme jeweils ab? Zwar ist nur ein Heizkreis eingestellt, aber in der API lassen sich auch Features zu weiteren Heizkreisen finden (die dann aber mit dem Flag "isEnabled" = false ausgestellt sind). Stelle daher sicher, dass du bei beiden Anlagen den Heizkreis "0" (heating.circuits.0. ...) abfragst. Ich hoffe, das hilft dir weiter. Gruß, Michael ... Mehr anzeigen

Hi @Hafenstrand , könntest du mir die Gateway Seriennummern beider Geräte zuschicken? Gerne als PN! Dann können wir uns das einmal genauer anschauen. Gruß, Michael   ... Mehr anzeigen

Hi @jdoelvers , leider können wir dir hier zu der Fehlermeldung in ioBroker keinen Support geben, da wir das Plugin nicht offiziell unterstützen. Am besten, du richtest direkt an die Entwickler des Plugins. Bei generellen Fragen zur API helfen wir dir hier vom Support gerne weiter! Gruß, Michael ... Mehr anzeigen

@ClaudeF um die API nutzen zu können, muss deine Anlage mit dem Internet verbunden sein. Abhängig von der Anlage ist entweder über ein externes Gateway (Vitoconnect)  möglich und wird über den Optolink Anschluss (in Form eines "V") an die Anlage angeschlossen. Oder deine Anlage besitzt ein integriertes WLAN-Modul, dann kannst du sie direkt mit dem Internet verbinden. Ist deine Anlage mit dem Internet verbunden und du hast dich erfolgreich in der ViCare App registriert, kannst du über das Developer Portal dir einen API Key erstellen. Ich hoffe, die Infos reichen erstmal aus. Gruß, Michael ... Mehr anzeigen

Neben dem Funktionsnamen gibt es noch eine kurze Beschreibung der Funktion. Aktuell bieten wir in der API Dokumentation leider noch keine weiteren Infos zur Funktion bereit. Den Rest findest du also, wenn du die Funktion über die API aufrufst. ... Mehr anzeigen

Hi @rebell , du findest eine Liste der verfügbaren Funktionen in unserer API Dokumentation. Filter die Liste dort einfach mal nach "gas" und dir werden verschiedene Funktionen zum errechneten Gasverbrauch angezeigt. Hinweis: Die Verfügbarkeit von Funktionen über API hängt auch vom Wärmeerzeuger sowie der Regelung im Wärmeerzeuger ab. Nicht immer sind alle in der API Dokumentation aufgelisteten Funktionen verfügbar. ... Mehr anzeigen

Hallo @rebell , danke für die Anfrage. Vorab: Leider kann ich dich im Detail nicht zu dem PyViCare Paket unterstützen, da wir das Paket offiziell nicht supporten. Konntest du über das API Dashboard erfolgreich einen Client erzeugen? Der Client wird auch als API Key bezeichnet. Vielleicht könnte eine Fehlerquelle auch das Passwort sein? Stell bitte sicher, dass du das korrekte Passwort verwendest oder versuche es auch mal, das Passwort in deinen Account Einstellungen zu ändern. Gruß, Michael ... Mehr anzeigen

@jasuim könntest du mir nochmal den API Request nennen, den du ausführst, von dem du die Fehlermeldung erhältst? Könntest du auch die volle Fehlermeldung teilen, also inklusive der Error ID? ... Mehr anzeigen

Hallo @abo2 , danke für deine Anfrage. Normalerweise sollte dein Account nach kurzer Zeit automatisch wieder nutzbar sein. Die Richtlinie für falsche Passworteingaben beim Login sieht wie folgt aus: Du hast 10 Versuche, dich einzuloggen. Nachdem alle 10 Anmeldeversuche fehlgeschlagen sind, wird dein Account für 5 Minuten gesperrt. Für jeden weiteren Fehlversuch wird dein Account erneut für 5 Minuten gesperrt. Nach 5 Minuten kannst du dich wieder anmelden. Nach deinem ersten erfolgreichen Login-Versuch hast du wieder 10 Versuche, bevor dein Konto gesperrt wird. Bitte stelle sicher, dass keine Anwendung versucht, sich einzuloggen, insbesondere wenn du ein falsches Passwort benutzt. Lass mich wissen, ob das Einloggen in dein Konto jetzt funktioniert. Falls du dein Passwort vergessen hast oder ändern möchtest, kannst du das hier tun. Gruß, Michael ... Mehr anzeigen

Hi @Uli12 , du findest alle aktuell in der public API verfügbaren Funktionen in unserer API Dokumentation. Beachte bitte, dass die Verfügbarkeit von Funktionen zum einen von der verbauten Regelung sowie dem Wärmeerzeuger abhängen. Zum anderen werden nicht alle Funktionen, die in der ViCare App vorliegen, auch über die public API angeboten. Gruß, Michael ... Mehr anzeigen

Hi @ralfbu , ich kann dir leider nicht sagen, warum die Home Assistant Integration genau nicht funktioniert, wir unterstützen die Integration nicht offiziell. Um aber in Richtung Lösungsfindung zu kommen, könntest du mal mit Hilfe der Postman Collection versuchen, die API selbst aufzurufen. Das stellt sicher, dass mit der API für dich alles funktionieren sollte. Den Rest müsste man dann in Richtung Home Assistant klären. Lass mich wissen, falls du mit der Ausführung der Postman Collection nicht weiter kommst. Gruß, Michael ... Mehr anzeigen

@Geri den API Client (API Key) zu löschen bringt nichts, sofern du mit deinem Client die API erfolgreich abrufen kannst, was ja bei dir der Fall ist. Über die public API bieten wir nicht den Zugriff auf alle Funktionen, die beispielsweise in der ViCare App verfügbar sind. Das hat verschiedene Gründe. Zum einen stehen nicht alle Daten in der public API bereit. Bisher sind hier größtenteils Betriebsparameter abgebildet, manche Daten in der App sind jedoch aufbereitete und historisierte Daten, die wir aktuell nur dort anbieten. Zum anderen wird auch in der Verfügbarkeit der Betriebsparameter zwischen App und public API unterschieden. Es ist daher wichtig, in der API Dokumentation auf die verfügbaren Funktionen zu schauen. Die public API wird sich stetig weiterentwickeln und immer mehr Funktionen und Möglichkeiten anbieten. ... Mehr anzeigen

Danke für die Nachricht! Nach erster Prüfung, scheint alles mit dem neu angelegten Client in Ordnung zu sein. Hast du die gleichen Probleme, wenn du die API direkt ausführst, also nicht über ioBroker? Hierzu könntest du einmal mit Hilfe unserer Postman Collection einen Test machen. Das hilft, eventuelle Probleme bei der Nutzung von ioBroker auszuschließen, da wir das Plugin offiziell nicht supporten. Gruß, Michael ... Mehr anzeigen

Hi @JJhome , die API bietet die Möglichkeit, den Betriebsmodus einzusehen und auch zu ändern. Die entsprechenden Funktionen in der API findest du in unserer Dokumentation. Die Funktionen heißen heating.circuits.N.operating.modes.*. Beispielsweise zeigt heating.circuits.N.operating.modes.active den aktiven Betriebsmodus an. Schau einmal rein und gib gerne ein Feedback, ob es hilft. Gruß, Michael ... Mehr anzeigen