Hobby API

Was ist die Hobby API?

Mit der Hobby API können Sie intelligente Lösungen selbst mit Ihrer Niko Home Control-Installation verknüpfen. Sie, als fortgeschrittener versierter Benutzer, können Niko Home Control mit Ihrer eigenen Anwendung oder mit Lösungen wie Node-RED, openHAB oder Home Assistant zusammenarbeiten lassen.

Niko oder Ihr professioneller Installateur unterstützen keine Anwendungen oder Lösungen, die Sie mit der Hobby-API erstellen. Zur Unterstützung verweist Niko auf die oben genannten Communities.

Was können Sie mit Niko Home Control machen?

Durch die Verwendung von Niko Home Control mit der Hobby API können Sie Folgendes tun:

• Abruf Ihrer verfügbaren Niko Home Control-Standorte

• Abruf Ihrer verfügbaren Niko Home Control-Aktionen und -Geräte

• Steuerung Ihrer Niko Home Control-Aktionen und -Geräte

• Abruf von Statusinformationen Ihrer Niko Home Control-Aktionen und -Geräte

• Empfang von Meldungen von Ihrer -Niko Home Control-Installation

Was benötigen Sie dazu?

	Kurze Zusammenfassung	Zusätzliche Informationen
Allgemeines	Es ist keine zusätzliche elektrische Verkabelung erforderlich. Sie verfügen über einen Computer mit einem Webbrowser und einer Internetverbindung. Sie haben MQTT- und JSON-Kenntnisse. Sie sind ein fortgeschrittener Benutzer, der sich mit Code auskennt und Sie haben eine großartige Idee.
	Ihr Niko Home Control-System erfüllt die folgenden Anforderungen: Es ist ein drahtloser intelligenter Hub oder ein Connected Controller vorhanden. Es wurde mit der neuesten Programmiersoftware (Version 2.17 oder höher) konfiguriert. Es besteht eine aktive Internetverbindung. Es ist registriert und Sie haben Ihre E-Mail-Adresse und Ihr Passwort zur Hand.	Wenn Sie Ihre Niko Home Control-Installation nicht registriert haben, gehen Sie bitte zumynikohomecontrol.niko.eu.
	Die Hobby API befindet sich auf Ihrem Connected Controller oder drahtlosen intelligenten Hub. Sie haben Ihr JWT-API-Zugangs-Token.	Wenn Sie kein Token haben, fordern Sie es über die Niko Home Control-Programmiersoftware an. Weitere Informationen siehe unten. Das Zugangs-Token muss jährlich erneuert werden. Die Vorgehensweise finden Sie unten.

Wie erhalten Sie Zugang zur Hobby-API (Dokumentation und Authentifizierung)?

1. Vergewissern Sie sich, dass Sie alles haben, was Sie brauchen (siehe oben).

2. Klicken Sie auf Dashboard.
   

   

3. Klicken Sie auf Vernetzte Dienste verwalten.
   

   

4. Klicken Sie im Abschnitt Zusätzliche erforderliche Schritte auf den Pfeil neben dem Hobby API-Logo.
   

   

5. Klicken Sie auf Verwalten.
   

   

6. Geben Sie Ihre E-Mail-Adresse und Ihr Niko Home Control-Passwort ein.

7. Klicken Sie auf Akzeptieren, um den Bedingungen zuzustimmen.
   

   

8. Klicken Sie auf Kopieren, um das Token abzurufen und es in Ihrer Anwendung zu verwenden.

9. Klicken Sie auf Fertig.

• Sie finden die API-Dokumentation im Aktivierungsfenster.

• Sie können den Benutzernamen im Aktivierungsfenster nicht ändern.

Wie erneuern Sie Ihr Zugangs-Token?

Über das Zugangs-Token:

• Das Token verfällt nach einem Jahr.

• Das Token muss jährlich erneuert werden.

• Eine Erneuerung ist frühestens einen Monat vor dem eigentlichen Ablaufdatum möglich.

• Sie werden von Niko nicht darüber informiert, dass das Token demnächst abläuft. Tipp: Sie können eine Benachrichtigung in der Software erstellen. Die Niko Home-App erinnert Sie daran, das Token zu erneuern.

1. Vergewissern Sie sich, dass Sie alles haben, was Sie brauchen (siehe oben).

2. Klicken Sie auf Dashboard.
   

   

3. Klicken Sie auf Vernetzte Dienste verwalten.
   

   

4. Klicken Sie im Abschnitt Zusätzliche erforderliche Schritte auf den Pfeil neben dem Hobby API-Logo.
   

   

5. Klicken Sie auf Verwalten.
   

   

6. Folgen Sie den weiteren Anweisungen auf Ihrem Bildschirm, um ein neues Token zu erhalten.