Nuki integráció

Módosítva ekkor Fri, 27 Oct 2023 ekkor: 03:58 PM

Nuki Smartlock Chameleon-ból 

 

Ami kell hozzá: 

  1. Nuki
    • Smart Lock
    • Bridge
    • Saját telefonos alkalmazása
    • Web Account
    • API Kulcs
    • Eszköz ID
  2. Chameleon
    • Virtual Switch

Nuki 

Először a Nuki Bridge és a Lock párosításához a Nuki saját telefonos appját kell használni, először a zárat a Bridge-re, majd utánna a Bridge-et kell feltanítani a wifi-re. Aztán a zár beállításaiban be kell kapcsolni a Nuki Web hozzáférést, amihez kell egy Nuki felhasználó. Ha ez megvan, a web.nuki.io oldalon elvileg lehet látni az eszközt. (Ajánlott a végfelhasználót regisztráltatni, hogy Nuki app-al is tudja vezérelni a zárat, ne tartozzon telepítőhöz egy csomó lakás zára.) 

Ezen az oldalon az API menüpont alatt aktiválni kell a Nuki Web API-t. 



Az eszközök külsős vezérlését egy API token-en keresztül lehet elérni, amit itt kell generálni. 


 


Fontos! Ez nem ugyanaz, mint az OAuth2 API key, ami feljebb jelenik meg. 

Az újonnan generált kulcsnak meg lehet adni, hogy mihez férjen hozzá egyesével, de célszerű mindent engedni. 

Ami kötelező, az a “View devices” és az “Operate devices”.


 


 

Save-gombra nyomba megjelenik a kulcs, amit felhasználunk a Chameleon config site-on a Virtual Switch-ben. 


 


Fontos! Ezt azonnal másoljuk ki, mert ha bezárjuk az ablakot már nem tudjuk kiolvasni a kulcsot, újat kell generálni. 

Ezt a kulcsot felhasználva le kell kérni az eszközeink ID-jét a Nuki API-n keresztül, a https://api.nuki.io/smartlock végponton keresztül, a kulcsot Authorization header-ben Bearer formátumban felhasználva. (Akármilyen REST API client-ből meglehet ezt tenni, akár Postman vagy letöltés nélkül például: https://reqbin.com


 


A visszatérési értékben található smartlockId kell majd, a Virtual Switch mezőibe, hogy elérje az eszközt. 



Chameleon

Chameleon-ban létrehozunk egy Virtual Switch-et, HTTP Header Auth-al. 

header-be bele kell írni:  

Authorization:Bearer <Ide jön az API Kulcs, amit az előbb másoltunk ki> 


 Kép beszúrása...
 

Ezután a Devices listában elnevezzük, elhelyezzük a Virtual Switch-et, és a HTTP on/off utl-be beillesztjük a következőket: 

On URL: https://api.nuki.io/smartlock/<ide jön az eszköz ID-je>/action/lock 

Off URL: https://api.nuki.io/smartlock/<ide jön az eszköz ID-je>/action/unlock 

Például: https://api.nuki.io/smartlock/17999290220/action/lock 

Send message üresen marad, a Method pedig POST. 




 

És kész! Most már a virtual switch tud nyitni/zárni.  

(így ON = Zárva, OFF = Nyitva, de meg lehet fordítani az URL-eket, ha a felhasználónak logikusabb valamiért.) 

Hasznosnak találta a cikket?

Nagyszerű!

Köszönjük visszajelzését

Sajnáljuk, hogy nem tudtunk segíteni

Köszönjük visszajelzését

Tudassa velünk hogyan javíthatnák ezen a cikken!

Válasszon ki legalább egy okot

Visszajelzés elküldve

Köszönjük közreműködését és megpróbljuk a cikket kijavítani