Віддалене управління приладами
Дане API призначене для передачі з вебсайту проекту (і додатків використовують REST API) команд управління навантаженням, а також для віддаленого конфігурування пристроїв моніторингу.
Передача команд відбувається відразу після отримання від приладу чергового пакету показань датчиків в уже відкритий сокет, що дозволяє управляти приладами з "сірими" IP знаходяться за роутерами (тобто за NAT).
Для протоколів TCP, GET, POST замість типового "OK" і при відсутності помилок, сервер проекту у відповідь на показання передає команди, починаючи з символу "#" і розділяючи команди через ";" без пробілів в хронологічному порядку щоб уникнути переповнення буфера прийому на слабких приладах до 5 за 1 сеанс.
Приклади TCP, GET, POST: gpio12=0 або дві команди: gpio12=0;gpio14=1
Приклад для JSON: {"devices":[{"mac":"DEVICE_MAC","commands":["gpio12=0","gpio14=1"]}]}
Можливість управління пристроями по протоколу MQTT доступна тільки для партнерів проекту і комерційних клієнтів!
Для протоколу MQTT відправка команди відбувається миттєво у зв'язку з тим, що пристрій підтримує активним з'єднання з сервером (брокером MQTT) за допомогою PUBLISH з QoS=1, тобто з очікуванням підтвердження прийому команди - PUBACK.
При відправці команд дописується префікс Username/Device/ (логін власника і назва пристрою).
Приклад для MQTT: output12=1 або system/restart=1 (для прошивок wifi-iot.com)
Команди на виконання можуть бути поміщені в чергу його власником у Датчики \ Настройка датчиків \ відправити команду на пристрій або ж по кліку на графічному перемикачі для датчиків "вкл / викл" і активного "Режимі керування пристроєм.
Якщо пристрій протягом години після відправки команди з сайту так і не вийшло на зв'язок з сервером, то дана команда видаляється з черги на виконання.
На момент публікації статті API керування пристроями підтримується на сайті проекту і в мобільних додатках для Андроїд 2019 і WinPhone/WinMobile.
Повний список підтримуваних команд слід шукати в інструкції до пристрою або дізнатися у його розробника.