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

Обновлено 22 декабря 2024

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

Умный дом 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 (см. раздел [Получение данных для подключения агента к облаку](/ru/smarthome/mqtt-diy/agent-authorization))

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

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

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

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

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

Топик:

sberdevices/v1/1234567/down/status_request

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

{
    "devices": [
        "ABCD_003"
    ]
}