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

Обновлено 4 августа 2023

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

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

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

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

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

Топик:

sberdevices/v1/<username>/down/status_request

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

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

Поле	Тип	Обязательное?	Описание
devices	dict<string object>	✔︎	Список идентификаторов устройств, состояние которых нужно вернуть

{
    "devices": [
        "device1_id": string,
        "device2_id": string,
        "device3_id": string
    ]
}

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

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

Топик:

sberdevices/v1/1234567/down/status_request

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

{
    "devices": [
        "ABCD_003"
    ]
}