Thinking Cleaner API (alkalmazásprogramozási felület)

Okosotthon-vezérlés

A Thinking Cleaner illesztése

Jelenleg a következő okosotthon-vezérlőkhöz illeszkedő beépülők (pluginek) és illesztőprogramok (driverek) állnak rendelkezésre (Domotica):
- IFTT (a Maker channel használatával)
- Homey
- Thermosmart (fejlesztés alatt)
- HomeWizard
- Gira Homeserver (KNX)
- Fibaro
- SmartThings
- Pebble
- Vera Mios
- HomeSeer
- Indigo domotics (fejlesztés alatt)
- Hubware SARAH
- PHEM
- Homekit
- Univerzális API. Készítettünk egy API-t, amely minden más rendszerhez illeszkedik. Ha Ön is szeretne beépülőt (plugint) vagy illesztőprogramot (drivert) készíteni, tudassa velünk!
Public server API

Gördítsen lejjebb, ha többet szeretne megtudni az elérhető beépülőkről…




IFTTTIFTTT (a Maker channel használatával)
Az IFTTT-t használva a takarítás elindítását és a dokkoltatást tudja használni a Thinking Cleanerrel. Ehhez a Maker channelt veszi igénybe. Alaposabb információkért kattintson az IFTTT beállítása lapra.

Továbbra is segítségre van szükségünk a saját csatorna kialakításához!
Sajnos még mindig nincs saját IFTTT csatornánk. Néhányszor próbálkoztunk, de még mindig nincs. Tehát, ha Ön is szeretne egy működő dedikált csatornát a Thinking Cleanerhez az IFTTT rendszerben, küldjön üzenetet a @IFTTT-nek a Twitteren vagy kérje az IFTTT Facebook-oldalán a Thinking Cleaner-támogatást. Remélhetőleg ez segíthet abban, hogy saját IFTTT-csatornánk legyen!




Homey-kompatibilitás:Homey
A Homey (http://www.athom.com , angol nyelvű oldal!) rendszeréhez fejlesztés alatt van egy plugin (Homey applikáció). Elkészül, amint a Homey forgalomba kerül.
app-store

Homey




Thermosmart:Thermosmart
A Thermosmart (http://www.thermosmart.com, angol nyelvű oldal!) szintén rendelkezni fog Thinking Cleaner-támogatással a közeljövőben.





HomeWizard compatible:HomeWizard
A Thinking Cleanert integráltuk a HomeWizard rendszerébe. Felveheti a Thinking Cleanert a HomeWizard applikáció "Add Sensor" menüpontjában. A Thinking Cleanert egy kapcsolóként (switch) rögzítheti a rendszerbe, elindítani pedig a "Scenes" (Események) között, megfelelően paraméterezve tudja.

HomeWizard



Gira Homeserver (KNX):
A Gira Homeservernek van egy egyszerű illesztőfelülete http-parancsok futtatására. Például a Roomba indítása a következő http-parancs futtatásával lehetséges: http://IP_ROOMBA/command.json?command=clean
A Thinking Cleanerből való adat-visszaolvasáshoz készítettünk egy Gira Homeserver-kompatibilis XML állományt. Az XML állományról és a Thinking Cleanernek küldhető utasításokról bővebb információt a Thinking Cleaner API dokumentációban talál.API document.

Gira_HomeserverGira_Homeserver



Fibaro:Fibaro
A Fibaróhoz egy nagyon jópofa plugin érhető el. Ennek beszerzéséhez látogassa meg a Fibaro fórumot ezen a linken: Fibaro forum link (angol nyelvű oldal!).




Fibaro plugin on Android



SmartThings plugin (készítette: pmjoen):SmartThings

A pluginek telepítéséhez és segítséghez, további információkhoz, valamint, ha kérdése van, böngéssze a SmartThings közösség oldalát (angol nyelvű oldal!).



Pebble applikáció (készítette: Tim):Pebble
Ha Pebble okosórát használ, látogassa meg a Pebble app store-t. (angol nyelvű oldal!) és töltse le az applikációt!






Pebble app screenshot 0   Pebble app screenshot 1   Pebble app screenshot 2




Vera Mios plugin (készítette: OtelConsulting):Vera

A Vera Mios plugin innen tölthető le:

Vera Mios app store (angol nyelvű oldal!)






Vera screenshot 0   Vera screenshot 1




HomeSeer plugin (made by Rien):Homeseer

The HomeSeer plugin is now available in the Homeseer app store. ••• It is a free pluging thanks to Rien du Pre. Here is a link to pdf documentation.

Homeseer screenshot 1


Indigo Domotics:Indigo domotics
Click here for the indigo plugin voor Thinking Cleaner.





Hubware: http://hubware.house/sarahHubware

Thinking Cleaner is pre installed on every SARAH Version (SARAH basic, standard and pro). The user just has to activate the gateway and SARAH starts to look for Thinking Cleaner Devices within their WLAN.
SARAH allows to place and steer Roomba on visual floorplans. Roomba can also be integrated into Scenes (e.g. ‘Cleaning Scene’) and also combined with triggers within ITTT automations.



FHEM Home automation:FHEM logo
Thanks to Julian the OpenSource home automation platform FHEM now supports the Thinking Cleaner. FHEM also supports Homekit integration (using it's own homebridge-fhem implementatipon) so THINKINGCLEANER indirectly also offers an alternative option for Homekit connectivity. Click here for more information.







Homekit:Homekit
A Thinking Cleaner jelenlegi verziója nem támogatja a Homekit out-of-the-box rendszerét a titkosításhoz használt egység miatt. Viszont használhatja a Homekit kiszolgáló applikációt ( https://github.com/nfarina/homebridge) a helyi számítógépén (vagy egy miniszámítógépen, mint például a Raspberry Pi NodeJS rendszerrel) és a Homekit applikációt okostelefonján (mint a MyTouchHome, az Insteon+ vagy egyéb applikációk), így lehetősége van a Sirit használva a Roomba indítására. Például működőképes lesz a Thinking Cleaner plugin Homebridge-hez.





ÁLTALÁNOS API

Minden egyéb okosotthon-vezérlőhöz használható az általános API:Thinking Cleaner API

Egy json API elérhető a Thinking Cleanerrel való közvetlen kommunikációhoz. Bárki fejleszthet saját applikációt a Thinking Cleaner vezérléséhez. Ez a módszer platformfüggetlen.
A legtöbb API-kommunikáció json utasításokkal zajlik, de - sok okosotthon-vezérlőhöz hasonlóan - alkalmas állapotlekérdezésre XML állományokon keresztül is.

WEBHOOK (web callback vagy http push API) elérhető a 1.0.80 vagy későbbi verziójú firmware-rel
A legutolsó API dokumentáció szintén leírja a webhook használatát a saját kiszolgálóján.
Az API dokumentáció (angol nyelvű!) innen letölthető. Felhívjuk figyelmét, hogy az API még fejlesztés alatt van, így előzetes értesítés nélkül is változtatunk rajta.
Az aktuális dokumentum verziószáma: V1.8.


Nyilvános kiszolgáló API
A Thinking Cleaner kiszolgálóhoz elérhető nyilvános API. A Thinking Cleaner kiszolgáló OAuth2-t használ titkosításhoz (http://oauth.net). Ha Ön fejlesztő és használná az API-t, kérjük, keressen meg minket a support@thinkingbits.nl címen és küldünk applikáció kulcsot és titkosítást.

Jelen pillanatban a következő lekérdezések érhetőek el:

get '/oapi/v1/devices'

Visszatér a felhasználó által regisztrált eszközök nevével. Azokkal is, amelyek épp nincsenek bejelentkezve. Ha a helyi hálózatban elérhető összes eszközre kíváncsi, használja a '/api/v1/discover/devices' lekérdezést.

get '/devices/'

Az eszköz állapotával tér vissza.

get '/devices//pending_commands'

Visszatér az eszköznek elküldött összes, függőben lévő utasítással. Attól a pillanattól, hogy egy parancsot elküld a kiszolgálónak, akár egy perc is eltelhet, amíg az eszköz végrehajtja azt, addig várólistán van. Ha az eszköz nincs csatlakoztatva (offline), a parancs várólistán marad.

post '/devices/:uuid/add_command'

Ennek a lekérdezésnek szüksége van egy parancsra (command). A lehetséges parancsok a következők: clean, dock, find_me, max és stop.

clean: takarítás indítása
dock: dokkoló keresésének indítása
find_me: lejátssza a "találj meg" dallamot a Roombán
max: nagytakarítás indítása (takarít, amíg a Roomba akkumulátora majdnem teljesen lemerül, majd dokkolót keres)