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 can make Niko Home Control work together with your own application or with solutions such as Node-RED, openHAB or Home Assistant.


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 shortExtra 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 have a great idea.

Your Niko Home Control system meets the following requirements:

  • It has a wireless smart hub or a connected controller II.
  • It is configured with the most recent programming software (version 2.5.1 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 mynikohomecontrol.niko.eu .

  • 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 on mynikohomecontrol.niko.eu. More information, see below.



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

  1. Check if you have everything you need (see above).

  2. Go to https://mynikohomecontrol.niko.eu.

  3. Log in with your e-mail address and password.

  4. Click the  Connected services button. This is where you manage all the services linked to your installation, including the Hobby API.

  5. Click the  ALL tab or the Add another service button in the ACTIVE tab.  
     

  6. Click the Hobby API logo.


  7. Follow the instructions on your screen.



You can find the technical Hobby API documentation on https://mynikohomecontrol.niko.eu.

How do you renew your Hobby API access token?

Your API access token expires after one year and needs to be renewed yearly. You can renew this token at the earliest one month before the actual expiration date.

  1. Go to https://mynikohomecontrol.niko.eu. 

  2. Log in with your e-mail address and password. 

  3. Click the  Connected services button. This is where you manage all the services linked to your installation, including the Hobby API.

  4. Click the Hobby API  logo.

  5. Follow the instructions on your screen to receive a new token.
  • No labels