Rest API integráció

Rest API HTTP hívásokkal is tudjuk működtetni okosotthonunkat másik eszközről. 

Settings - Engedélyezni tudjuk (Enable) a Rest API-t a Controlleren, illetve újra tudjuk generálni az API kulcsot (Regenerate), ha az esetleg kompromitálódott, ezzel megelőzve a jogosulatlan hozzáférést. 

Endpoints:

 Itt láthatjuk a HTTP hívásokkal módosítható és lekérdezhető végpontokat. 

State Registers: 

Minden State Register-nek van egy Id-je. Ezt megtudhatjuk egyszerűen, ha átnavigálunk az eszközök közé, kiválasztjuk azt, amit használni szeretnénk. Ekkor a Fine Tune > State Registers alatt láthatjuk, hogy melyik értékhez melyik azonosító tartozik, ha felé visszük a kurzort. 

Heating-Cooling:

Itt a globális fűtés-hűtés zónának az állapotát adhatjuk meg vagy kérdezhetjük le. Ez lehet heat, cool vagy off.

System Settings:

Beállíthatjuk és lekérdezhetjük, hogy a Condominium mód be vagy ki van kapcsolva. Lehetséges értékei true és false.

Other:

Itt scenariokat lehet aktiválni és deaktiválni valamint az állapotukat lekérdezni. Pl 1-es Id scenario indítása: {"Id":1,'activate':true}

Egy HTTP hívás menete:

Legyen példánkban négy Chameleon Controller egy három lakásos társasházi környezetben (lakásonként egy + közösségi Controller). Szeretnénk a ház közös ajtaját, ami a közösségi Controller 1-es Id-val rendelkező State Registerére van kötve, minden lakásból nyitni. Tételezzük fel, hogy a Controllerek közös hálózaton vannak, így helyi hálózaton IP címmel látják egymást. Ekkor az 1-es lakásban az ajtónyitás felkonfigurálása a következő lépésekkel lehetséges: 

• Hozzunk létre az 1-es lakás Controllerén egy Virtuális Switch eszközt (Integrations>Virtual Devices>New Virtual Device). Állítsuk be az Authentication Type: Authentication With HTTP Headers értéket. Ezutána a HTTP Headers mezőbe másoljuk be a közösségi Controller API kulcsát ilyen formán: Authorization:Bearer 'Api kulcs' Figyeljünk rá, hogy szóköz csak a kulcs előtt van!
  
  
• Nyissuk meg az előbb létrehozott Virtual Switch-et. Nevezzük el, adjunk neki helyiséget, ahogy tennénk azt egy normális switch esetében is. Nevezzük el a portot is, állítsunk be ennek is helyet valamint töltsük ki megfelelően a Type, Category és Hidden mezőket is. Ha ezekkel megvagyunk menjünk át a Fine Tune menübe.

• Itt a HTTP on url-be írjuk be ezt az url-t (Mivel a switch bekapcsolásakor szeretnénk hogy kinyisson az ajtó ezért az on-ba írtuk, ha a switch kikapcsolására szeretnénk indítani akkor természetesen a HTTP off url-be kell beírni): http://'közösségi Controller IP':9000/v1/states/'state register Id'  (természetesen a Controller IP-t és state register Id-t behelyettesítve). Példánkban ez így fog kinézni: http://192.168.100.10:9000/v1/states/1 
• A HTTP send message mezőbe írjuk a "{value}" értéket.  Ez biztosítja, hogy a közösségi controlleren is bekapcsoljon a relé. 
• Ezután már csak a HTTP method-ot kell kiválasztani, hogy PUT legyen.Ezzel kész is vagyunk, ha most ezt a switchet felkapcsoljuk felkapcsol vele a közösségi Controller switche is.