Thema "Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???" in The Viessmann API

Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

Willly — Thu, 31 Mar 2022 18:49:48 GMT

Hallo Zusammen,

ich möchte meine Viessmann Vitocal 222 G in mein Home Assistand einbinden. Aktuell bediene ich die Anlage über die ViCare App.

Nun benötige ich eine API um die Daten über Home Assistant abzurufen. Ich habe auch einen Account bei Viessmann Developer angelegt aber ich komme nicht weiter. Wie komme ich an die API?

Könnt Ihr mir helfen?

Gruß Willy

Re: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

CustomerCareMichael — Mon, 04 Apr 2022 12:25:32 GMT

Hallo @Willly ,

Es ist super, dass du bereits den Weg zum Developer Portal und hierher gefunden hast. Das heißt du bist nicht mehr weit entfernt, die API zu nutzen 🙂

Die einzelnen Punkte um die API zu nutzen sind auf unserem Developer Portal erklärt: https://developer.viessmann.com/ (runterscrollen zum Punkt "How it works"). Außerdem findest du im Bereich "Developer" noch eine genauere Beschreibung für individuelle User: https://developer.viessmann.com/start/benefits-developers.html

Kurz gesagt, nachdem du einen Login besitzt und dich auf dem Developer Portal angemeldet hast, kannst du unter My Dashboard einen eigenen API client ( = API key) erzeugen. Die Parameter für die Einstellung deines API Keys findest du sicher bei Home Assistant selbst, ich habe dazu z.B. dies gefunden: https://www.home-assistant.io/integrations/vicare/

Damit kann die Nutzung der API schon los gehen. Wenn du wissen möchtest, was du mit der API alles anfangen kannst, schau gerne bei unseren API Produkten rein: https://developer.viessmann.com/start/api-products.html. Besuche auch unsere API Dokumentation, wenn du selbst mit der API entwickeln und mehr über die technische Funktionsweise der API wissen möchtest: https://documentation.viessmann.com/

Ich hoffe, das gibt dir einen ersten Überblick. Meld dich bei Fragen gerne.

Gruß,

Michael

Re: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

AlKna — Tue, 05 Apr 2022 15:07:41 GMT

Hallo @CustomerCareMichael ,

auch ich habe den Weg hierher gefunden 😊.

Ich würde ebenfalls gern meine bestehende Heizungsanlage in mein openHab einbinden.

Leider komme ich nicht auf mein "Dashboard" und kann mir somit keinen API-Key erzeugen...

Ich werde immer auf eine Seite weitergeleitet die mir sagt das Portal ist nicht verfügbar Developer Portal (viessmann.com).

Kannst du auch mir ggf. einen Tipp geben was ich falsch mache?

Danke schonmal und viele Grüße

Alex

Re: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

Willly — Tue, 05 Apr 2022 20:30:37 GMT

Hallo MichaelHanna,

vielen Dank für die Infos. Ich denke soweit bin ich schon gekommen, wenn "Your Client ID" dem API Key entspricht.

Wenn ich die Client Nummer in Home Assistant eintrage bekomme ich eine Fehlermeldung. Vermutlich hat das was mit OAuth 2 zu tun. Das allerdings habe ich noch nicht begriffen. Mit der Anleitung, den API Key zusätzlich über OAuth zu registrieren komme ich nicht zurecht.

Gibt es hier eine einfache, für nicht Programmierer, verständliche Anleitung?

Danke und schöne Grüße

Willy

Re: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

CustomerCareMichael — Wed, 06 Apr 2022 05:33:00 GMT

@AlKna könntest du mir die Mail Adresse nennen, mit der du versuchst dich im Dashboard einzuloggen? Gerne per Direktnachricht hier im Forum.

@Willly exakt "Your Client ID" entspricht deinem API Key. Meiner Erwartung nach sollte es seitens Home Assistant eine Anleitung geben, wie man mittels API Key und Login (Email + PW) seine Anlage mit der Viessmann Integration von Home Assistant verknüpft. Schau bitte nochmal auf der Seite die ich oben gepostet habe, dort ist ein automatischer und ein manueller Weg beschrieben. Ich gehe davon aus, dass die Integration auch die OAuth Authentifizierung übernimmt.

Gruß,

Michael

Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

ITBM — Sat, 30 Apr 2022 07:09:25 GMT

Hallo.

nach Auswahl eines Packages komme ich immer auf https://app.developer.viessmann.com/forbidden

Bitte um Hilfe für APIcode

LG Manuel

Re: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

ITBM — Sat, 30 Apr 2022 07:26:11 GMT

mydashboard swhe ich nur persönliche daten

Re: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

CustomerCareMichael — Mon, 02 May 2022 07:05:22 GMT

@ITBM könntest du mir zur Überprüfung deinen Login ID nennen (das ist die Mail Adresse mit der du versuchst dich einzuloggen)?

Re: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

ITBM — Mon, 02 May 2022 14:37:45 GMT

sm@blumma.com

Re: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

CustomerCareMichael — Tue, 03 May 2022 06:58:57 GMT

@ITBM Danke. Ich habe dein Account überprüft und festgestellt, dass du einen sogenannten 'lite account' verwendest, um dich beim Developer Portal anzumelden. Mit einem lite account kannst du das Developer Portal nicht nutzen. Bitte verwende den gleichen Account, den du auch für die ViCare-App verwendest. Auf diese Weise kannst du dich anmelden und über die API Zugang zu deinem eigenen Heizsystem erhalten.

Re: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

ITBM — Fri, 06 May 2022 07:13:10 GMT

danke.

dachte account selbiger, muss jetzt app checken.

Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

Crusha — Sat, 23 Jul 2022 10:01:21 GMT

Hi, ich habe das selbe Problem. Gebe bei Home Assistant meine E-Mail und Passwort ein, welche ich auch in der APP nutze und die Client ID = API, aber ich erhalte immer eine "Ungültige Authentifizierung".

Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

Andy1136 — Tue, 26 Jul 2022 12:23:37 GMT

Genau das gleiche auch bei mir. Email+PW sind sicherlich richtig und der API = Id aus Your clients aus der Viessmann-Developer-Seite liefert bei mir auch "Ungültige Authentifizierung".

Wer weiß Rat?

Liebe Grüße,

Andy

Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

Andy1136 — Tue, 26 Jul 2022 13:07:46 GMT

Ich habe es bei mir mit dem "Ungültige Authentifizierung"-Problem gerade geschafft.

Bezugnehmend auf die Doku Viessmann ViCare - Home Assistant (home-assistant.io):

Ich habe folgende 3 Punkte in der API korrigiert:

Name: PyViCare

Google reCAPTCHA: Disabled

Redirect URIs: vicare://oauth-callback/everest

Dann ging es bei mir. Ich hoffe, es hilft Euch auch 🙂

Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

Crusha — Tue, 26 Jul 2022 13:15:38 GMT

Ok, total strange. Hatte das eingegeben und gestestet, aber bei mir funktioniert es trotzdem nicht. Hast du zufällig noch etwas anderes angepasst?

Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

Crusha — Tue, 26 Jul 2022 13:17:09 GMT

Ok, vergiss es :). Habe die Client ID noch einmal komplett gelöscht und erstellt. Jetzt funktioniert es! Ich danke dir für die Recherche!

Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

WaD2022 — Mon, 15 Aug 2022 16:21:27 GMT

Hallo, bei mir hat geholfen ein Passwort ohne Sonderzeichen zu verwenden. Oauth2 etc. Ist nicht manuell notwendig, es reicht die api id zu erstellen.

Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

ckoeber — Thu, 15 Sep 2022 20:14:19 GMT

Hi Willy,

schau mal hier

Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

Willly — Fri, 16 Sep 2022 04:57:32 GMT

Vielen Dank noch mal für die Info. Aber die kenne ich alle schon.

Ich hatte die Integration ein paar Tage laufen, bis es plötzlich wieder nicht mehr ging. Nach mehreren Versuchen und neu API war die Integration wieder online. Nun ist sie wieder weg. Das Heizsystem ist online und per App erreichbar. Ich weiß mir keinen Rat mehr....

Betreff: Einbindung der VitoCal in Home Assistant - Wie komme ich an die API???

metawops — Sun, 25 Sep 2022 12:00:59 GMT

Hallo zusammen,

ich habe gerade ein sehr ähnliches Thema, möchte auch meine Anlage in Home Assistant integrieren.

Mein "Fall" ist: Ich hatte mich bereits vor längerer Zeit (> 1 Jahr) als Developer registriert und damals auch einen API Key angelegt, für erste Programmier-Experimente.

Jetzt würde ich gerne EINEN ZWEITEN API Key anlegen, für die Home Assistant Integration. Das scheint aber nicht möglich zu sein, oder? Denn ich sehe nirgendwo im Portal eine entsprechende Funktionalität.

Kann ich also nur einen API Key anlegen?

Dann muss ich meinen alten wohl erst löschen?

Hoffentlich kann ich, wenn ich den vorhandenen API Key gelöscht habe, tatsächlich einen neuen anlegen. Aktuell sehe ich ja keinerlei "Knopf" oder Menüpunkt dafür ...

Für Rat bin ich sehr dankbar! 😊 🙏

Viele Grüße
Stefan.