Hobby API

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?

By using Niko Home Control with the hobby API, you can do the following:

• Retrieve your available Niko Home Control locations

• Retrieve your available Niko Home Control actions and devices

• Control your Niko Home Control actions and devices

• Receive status information from your Niko Home Control actions and devices

• Receive notification messages from your Niko Home Control installation

What do you need?

	In short	Extra information
General	No additional electrical wiring is required. You have a computer with a web browser and an internet connection. You have knowledge of MQTT and JSON. You are an advanced code-savvy user and you have a great idea.
	Your Niko Home Control system meets the following requirements: It has a wireless smart hub or a connected controller. It is configured with the most recent programming software (version 2.17 or higher). It has an active internet connection. It is registered and you have your e-mail address and password on hand.	If you have not registered your Niko Home Control system, go to https://guide.niko.eu/en/umnhc2/lv/register-your-installation.
	The Hobby API is on your connected controller or wireless smart hub. You have your JWT API access token.	If you have no token, request it via the Niko Home Control programming software. More information, see below. The access token needs a yearly renewal. You find the procedure below.

How do you get access to the hobby API (documentation and authentication)?

1. Make sure you have everything you need (see above).

2. Click on Dashboard.
   

   

3. Click on Manage connected services.
   

   

4. In the Additional steps required section, click the arrow next to the hobby API logo.
   

   

5. Click on Manage.
   

   

6. Fill in your e-mail address and Niko Home Control password.

7. Click on Accept to agree with the terms & conditions.
   

   

8. Click on Copy to retrieve the token and use it in your application.

9. Click on Done.

• You can find the API documentation in activation window.

• 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.

1. Make sure you have everything you need (see above).
   
   

2. Click on Dashboard.
   

   

   
   
   

3. Click on Manage connected services.
   

   

   
   
   

4. In the Additional steps required section, click the arrow next to the hobby API logo.
   

   

   
   
   

5. Click on Manage.
   

   

   
   
   

6. Follow the instructions on your screen to receive a new token.