ym88659208ym87991671
Запрос статуса устройств (status_request) | Документация SmartMarket
Skip to main content

Запрос статуса устройств (status_request)

Направление: облако → контроллер.

Умный дом Sber запрашивает у приложения-агента на контроллере актуальное состояние устройств. В ответ агент должен отправить сообщение sberdevices/v1/<username>/up/status.

Пример ситуации использования:

  1. Пользователь вручную изменяет состояние какого-либо устройства. Например, выключает лампочку.
  2. Умный дом периодически запрашивает у приложения-агента на контроллере состояние устройств пользователя.
  3. Агент получает от контроллера актуальное состояние устройств, включая текущее состояние лампочки. Затем отправляет сообщение sberdevices/v1/<username>/up/status.
  4. Умный дом Sber актуализирует состояние лампочки в приложении Салют, на SberPortal, SberBox и других устройствах с ассистентами Салют.

Формат сообщения

Топик:

sberdevices/v1/<username>/down/status_request
ПараметрТипОбязательный?Описание
usernamestring✔︎Логин, с которым осуществляется подключение к MQTT-серверу Sber (см. раздел «Получение данных для подключения контроллера к облаку Sber» для интеграторов и для DIY-энтузиастов)

Тело сообщения:

ПолеТипОбязательное?Описание
devicesdict<string object>✔︎Список идентификаторов устройств, состояние которых нужно вернуть
{
"devices": [
"device1_id": string,
"device2_id": string,
"device3_id": string
]
}

Пример сообщения

Умный дом запрашивает у приложения-агента на контроллере состояние розетки.

Топик:

sberdevices/v1/1234567/down/status_request

Тело сообщения:

{
"devices": [
"ABCD_003"
]
}
Обновлено 28 апреля 2022

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней