ym88659208ym87991671
Передача статуса устройств (status) | Документация для разработчиков

Передача статуса устройств (status)

Обновлено 11 марта 2024

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

Приложение-агент на контроллере уведомляет умный дом Sber об изменении состояния устройства.

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

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

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

Топик:

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

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

ПолеТипОбязательное?Описание
devicesdict<string object>✔︎Устройства, сведения о состоянии которых передаются. Для каждого устройства передаются ID устройства в системе вендора и состояние его функций
IDstring✔︎ID устройства в системе вендора
stateslist<object>✔︎Список состояний (см. Состояние устройства (state))
{
"devices": [
"id": {
"states": [
{
"key": string,
"value": {
"type": string,
"type_value": object
}
},
{
// ...
}
]
}
]
}

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

Приложение-агент на контроллере уведомляет умный дом Sber об изменении состояния функций online и on_off розетки.

Топик:

sberdevices/v1/1234567/up/status

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

{
"devices": [
"ABCD_003": {
"states": [
{
"key": "online",
"value": {
"type": "BOOL",
"bool_value": true
}
},
{
"key": "on_off",
"value": {
"type": "BOOL",
"bool_value": true
}
}
]
}
]
}
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.