Hobby API

Qu'est-ce que l'API Hobby ?

Avec l'API Hobby, vous pouvez connecter vous-même des solutions intelligentes à votre installation Niko Home Control. Vous, en tant qu'utilisateur expert en code, pouvez faire fonctionner Niko Home Control avec votre propre application ou avec des solutions comme Node-RED, openHAB ou Home Assistant.

Niko ou votre installateur professionnel ne prennent pas en charge les applications ou les solutions que vous créez avec l'API Hobby. Pour obtenir de l'aide, Niko renvoie aux communautés dont la liste est présentée ci-dessus.

Que pouvez-vous faire avec Niko Home Control ?

En utilisant Niko Home Control avec l'API Hobby, vous pouvez :

• Récupérer vos emplacements Niko Home Control disponibles.

• Récupérer vos actions et appareils Niko Home Control disponibles.

• Commander vos actions et appareils Niko Home Control.

• Recevoir des informations de statut de vos actions et appareils Niko Home Control.

• Recevoir des messages de notification envoyés par votre installation Niko Home Control.

De quoi avez-vous besoin ?

	En bref	Informations supplémentaires
Généralités	Aucun câblage électrique supplémentaire n'est requis. Vous avez un ordinateur avec un navigateur web et une connexion à l'Internet. Vous avez des connaissances de MQTT et JSON. Vous êtes un utilisateur expert en code et avez une idée géniale.
	Votre système Niko Home Control répond aux conditions suivantes : Il dispose d'un hub intelligent sans fil ou d'une unité de contrôle connectée. Il est configuré avec le logiciel de programmation le plus récent (version 2.17 ou supérieure). Il dispose d'une connexion à Internet active. Il est enregistré et vous avez votre adresse e-mail et votre mot de passe sous la main.	Si vous n'avez pas enregistré votre système Niko Home Control, rendez-vous sur mynikohomecontrol.niko.eu.
	L'API Hobby est sur votre unité de contrôle connectée ou votre hub intelligent sans fil. Vous avez votre jeton d'accès API JWT.	Si vous n'avez pas de jeton, demandez-le via le logiciel de programmation Niko Home Control. Pour plus d'informations, cf. ci-dessous. Le jeton d'accès doit être renouvelé chaque année. La procédure est présentée ci-dessous.

Comment avoir accès à l'API Hobby (documentation et authentification) ?

1. Assurez-vous d'avoir tout ce dont vous avez besoin (voir ci-dessus).

2. Cliquez sur Tableau de bord.
   

   

3. Cliquez sur Gérer les services connectés .
   

   

4. Dans la section   Étapes supplémentaires requises, cliquez sur la flèche située à côté du logo hobby API.
   

   

5. Cliquez sur Gérer.
   

   

6. Entrez votre adresse e-mail et votre mot de passe Niko Home Control.

7. Cliquez sur Accepter pour accepter conditions générales.
   

   

8. Cliquez sur Copier pour récupérer le jeton et l'utiliser dans votre application.

9. Cliquez sur Terminé.

• Vous trouverez la documentation de l'API dans la fenêtre d'activation.

• Vous ne pouvez pas modifier le nom d'utilisateur dans la fenêtre d'activation.

Comment renouveler le jeton d'accès ?

À propos du jeton d'accès :

• Le jeton expire après un an.

• Le jeton doit être renouvelé chaque année.

• Le renouvellement est possible au plus tôt un mois avant la date d'expiration proprement dite.

• Vous ne serez pas informé par Niko que le jeton est sur le point d'expirer. Conseil : Vous pouvez créer une notification dans le logiciel. L'appli Niko Home vous rappellera de renouveler le token.

1. Assurez-vous d'avoir tout ce dont vous avez besoin (voir ci-dessus).

2. Cliquez sur Tableau de bord.
   

   

3. Cliquez sur Gérer les services connectés.
   

   

4. Dans la section   Étapes supplémentaires requises, cliquez sur la flèche située à côté du logo hobby API.
   

   

5. Cliquez sur Gérer.
   

   

6. Suivez les instructions affichées à l'écran pour recevoir un nouveau jeton.