What is the hobby API?
By using the hobby API you can link smart solutions to your Niko Home Control installation yourself as well. You, as an advanced code-savvy-user, can make Niko Home Control work together with your own application or with solutions such as Node-RED, openHAB or Home Assistant.
Niko or your professional installer do not support applications or solutions you build with the hobby API. For support, Niko refers to the communities listed above.
What can you do with Niko Home Control?
For an overview, see Connections to third-party systems > Hobby API.
What do you need?
Before proceeding with activation, please consult the requirements (general, Niko, and Hobby API); see Connections to third-party systems > Hobby API.
How do you get access to the hobby API (documentation and authentication)?
-
Make sure you have everything you need (see above).
-
Click on Dashboard.
-
Click on Manage connected services.
-
In the Additional steps required section, click the arrow next to the hobby API logo.
-
Click on Manage.
-
Fill in your e-mail address and Niko Home Control password.
-
Click on Accept to agree with the terms & conditions.
-
Click on Copy to retrieve the token and use it in your application.
-
Click on Done.
-
You can find the API documentation here.
-
You can't change the username in the activation window.
How do you renew the access token?
About the access token:
-
The token expires after a year.
-
The token needs a yearly renewal.
-
A renewal is possible at the earliest one month before the actual expiration date.
-
You are not informed by Niko that the token is about to expire. Tip: You can create a notification in the software. The Niko Home app will remind you to renew the token.
-
Make sure you have everything you need (see above).
-
Click on Dashboard.
-
Click on Manage connected services.
-
In the Additional steps required section, click the arrow next to the hobby API logo.
-
Click on Manage.
-
Follow the instructions on your screen to receive a new token.