Справочный центр

Описание протоколов API / MQTT

Зачем нужен API к ЛК Эктострой?

Если необходимо автоматически собирать статистику работы устройств системы ectoControl, воспользуйтесь одним из доступных способов: API с использованием HTTP-запросов или протокол MQTT. Для использования этих методов достаточно зарегистрироваться в ЛК, перейти на страницу настроек пользователя, в верхнем меню выбрать пункт "Интеграция" и получить токен, с помощью которого будет происходить авторизация на сервере ЛК.

Давайте разберемся, какие методы можно использовать и как они работают.

Функционал HTTP API:

  • получение основных данных;
  • всех устройств из ЛК;
  • получение базовой информации по конкретному устройству;
  • установка состояния реле, кранов.

Достоинство такого метода - простота реализации. Однако для получения своевременной информации запросы нужно делать периодически, чтобы не пропустить важных изменений.

Функционал MQTT API:

  • получение основных данных всех устройств из ЛК;
  • получение базовой информации по конкретному устройству;
  • установка состояния реле, кранов;
  • получение значений и состояний устройств без запроса, по подписке.

Достоинство такого метода - брокер MQTT сам вышлет необходимые данные по мере их изменения, что существенно снижает нагрузку на приложение пользователя. Однако применение такого подхода требует установки дополнительных программных пакетов на стороне пользователя.


ВАЖНО! В настоящий момент интеграция поддерживает только часть функций ЛК, пожалуйста, ознакомьтесь с документацией по ссылкам выше.

Рекомендуемые статьи:

К этой статье мы прикрепили еще несколько интересных статей для Вас. Они помогут быстрее разобраться в возможностях системы и использовать весь её широкий функционал. Переходите, читайте :-)

Скачать приложение ectoControl
В статье мы разместили ссылки на приложение ectoControl в AppStore и GooglePlay. Также для владельцев китайских телефонов мы разместили ссылку *apk файл приложения. Скачивайте приложение, делайте свою жизнь проще :-)
Как проверить версию прошивки устройств!?
В статье мы подробно рассказываем процесс отправки SMS-запроса на систему ectoControl для проверки прошивок внешних устройства. В ответе системы Вы получите версии прошивок, пределы датчиков и другие параметры.
Резервирование настроек системы (backup)
В статье описаны все варианты создания резервной копировании настроек системы ectoControl. В приложении и в web-кабинете браузера. Действуя по этой инструкции, проблем с созданием не возникнет.