Loslegen

Erhalte schnell und einfach Zugriff auf die Viessmann APIs.

Mit diesen 4 Schritten kannst du in weniger als 5 Minuten mit dem Aufruf der Viessmann APIs beginnen:

Generic placeholder image

1. Die APIs entdecken

Generic placeholder image

2. Account erstellen

Generic placeholder image

3. API-Key abrufen

Generic placeholder image

4. Ersten API-Call machen

Generic placeholder image

1. Die APIs entdecken

Alle unsere APIs findest du in unserer API Dokumentation. Wenn du dir nicht sicher bist, welche API für deinen Fall geeignet ist, findest du eine Anleitung in unserem Abschnitt Auswahl der richtigen API.

Generic placeholder image

2. Account erstellen

Um dich auf dem Developer Portal anzumelden, benötigst du einen Viessmann Account. Dabei handelt es sich um denselben Account, den du beispielsweise als Login für die ViCare App bereits verwendest. Nutze also entweder deine vorhandenen Login Daten oder registriere dich zunächst hier, um dich anschließend im Portal anzumelden. Willkommen im Viessmann Developer Portal! Akzeptiere die Nutzungsbedingungen des Portals und es kann sofort losgehen.

Generic placeholder image

3. API-Key abrufen

Um mit der Verwendung der APIs zu beginnen, musst du dem System zunächst mitteilen, dass du dazu berechtigt bist. Dieser Prozess wird als Authentifizierung bezeichnet.

Alles was du tun musst, ist eine alphanumerische Zeichenkette namens Token an deine API-Calls anzuhängen. Dieses Token identifiziert dich als gültigen Benutzer und wird aus zwei Parametern generiert: API-Key und API-Secret.

Das Erhalten des API-Keys und des API-Secrets ist einfach. Sobald du dich auf dem Developer Portal angemeldet hast, kannst du diesen Schritten folgen:

  • Klicke auf API-Keys in der Navigation
  • Klicke auf die Schaltfläche "Neuen Client erstellen"
  • Gib die Daten für deine Anwendung ein und klicke auf Client anlegen

Generic placeholder image

4. Ersten API-Call machen

Bevor du deinen ersten API-Call ausführen kannst, musst du ein Zugriffstoken erhalten. Aus Sicherheitsgründen haben wir den OAuth2-Prozess implementiert, der dir dein Zugriffstoken basierend auf deinem API Key und API Secret gibt: Bitte schau dir dazu auch unseren Abschnitt Authentifizierung in der API-Dokumentation an.

Du benötigst Hilfe?

Schau in unsere Erste Schritte Dokumentation oder sende uns eine E-Mail an developer@viessmann.com