Hobby API

Čo je hobby API?

Pomocou hobby API môžete svojpomocne prepojiť inteligentné riešenia s vašou inštaláciou Niko Home Control. Ako používateľ, ktorý je veľmi zbehlý v oblasti programovania, viete zabezpečiť, aby systém Niko Home Control spolupracoval s vašimi vlastnými aplikáciami alebo s riešeniami ako Node-RED, openHAB alebo Home Assistant.

Spoločnosť Niko alebo odborní inštalatéri nedokážu zabezpečiť podporu pre aplikácie alebo riešenia, ktoré ste vytvorili pomocou hobby API. Ak potrebujete pomoc, obráťte sa na vyššie uvedené komunity odporúčané spoločnosťou Niko.

Čo môžete urobiť pomocou Niko Home Control?

Keď používate Niko Home Control spolu s hobby API, môžete:

• Získať dostupné lokality Niko Home Control

• Získať dostupné akcie a zariadenia Niko Home Control

• Ovládať akcie a zariadenia Niko Home Control

• Prijímať informácie o stave z akcií a zariadení Niko Home Control

• Prijímať upozornenia zo svojej elektroinštalácie Niko Home Control

Čo budete potrebovať?

	V krátkosti	Dodatočné informácie
Všeobecné	Nie je potrebná žiadna dodatočná elektrická kabeláž. Úplne vám postačí počítač s webovým prehliadačom a pripojením na internet. Musíte sa vyznať v MQTT a JSON. Ako používateľ musíte byť veľmi zbehlý v oblasti programovania a musíte mať skvelé nápady.
	Váš systém Niko Home Control musí spĺňať nasledujúce požiadavky: Musí obsahovať bezdrôtový smart hub alebo connected controller. Musí byť nakonfigurovaná pomocou najnovšieho programovacieho softvéru (verzia 2.17 alebo vyššia). Musí mať aktívne pripojenie na internet. Musí byť zaregistrovaný a musíte mať poruke svoju e-mailovú adresu a heslo.	Ak ste svoj systém Niko Home Control ešte nezaregistrovali, prejdite na stránku Registrácia inštalácie.
	Hobby API sa nachádza na module connected controller alebo na bezdrôtovom smart hube. Máte svoj prístupový token JWT API.	Ak nemáte žiaden token, požiadajte oň prostredníctvom programovacieho softvéru Niko Home Control. Viac informácií nájdete nižšie. Prístupový token si musíte obnoviť každý rok. Postup na obnovenie je uvedený nižšie.

Ako získate prístup k hobby API (dokumentácii a autentifikácii)?

1. Uistite sa, že máte všetko potrebné (pozrite si informácie uvedené vyššie).

2. Kliknite na Informačný panel.
   

   

3. Kliknite na Spravovať pripojené služby.
   

   

4. V sekcii Dodatočné požadované kroky kliknite na šípku nachádzajúcu sa vedľa loga Hobby API.
   

   

5. Kliknite na Spravovať.
   

   

6. Zadajte svoju e-mailovú adresu a heslo pre Niko Home Control.

7. Pre potvrdenie súhlasu s podmienkami kliknite na Prijať.
   

   

8. Pre získanie tokenu a jeho použite vo vašej aplikácii kliknite na Kopírovať.

9. Kliknite na Hotovo.

• API dokumentáciu nájdete v aktivačnom okne.

• V aktivačnom okne nemôžete zmeniť meno používateľa.

Ako obnoviť prístupový token?

Informácie k prístupovému tokenu:

• Platnosť tokenu je jeden rok.

• Token si musíte obnoviť každý rok.

• Môžete ho obnoviť najskôr jeden mesiac pred uplynutím dátumu platnosti.

• Spoločnosť Niko vás však nebude informovať o nadchádzajúcom uplynutí platnosti tokenu. Tip: Upozornenie na končiacu platnosť si môžete vytvoriť v softvéri. Aplikácia Niko Home vás upozorní, že si musíte obnoviť token.

1. Uistite sa, že máte všetko potrebné (pozrite si informácie uvedené vyššie).
   
   

2. Kliknite na Informačný panel.
   

   

   
   
   

3. Kliknite na Spravovať pripojené služby.
   

   

   
   
   

4. V sekcii Dodatočné požadované kroky kliknite na šípku nachádzajúcu sa vedľa loga Hobby API.
   

   

   
   
   

5. Kliknite na Spravovať.
   

   

   
   
   

6. Postupujte podľa pokynov na obrazovke, aby ste získali nový token.