Передача состояния устройств (post state)
Обновлено 15 июля 2025
Вендор уведомляет умный дом Sber об изменении состояния устройства пользователя.
Пример ситуации использования:
- Состояние функции устройства по какой-то причине изменилось. Например, лампочку отключили от электричества или изменили ее цвет в приложении вендора.
- Вендор уведомляет умный дом Sber об изменении состояния устройства.
- Умный дом Sber меняет состояние устройства в приложении Салют, приложении СберБанк Онлайн, на SberBox и других устройствах с ассистентом Салют.
Формат запроса
Вендор отправляет уведомление на эндпоинт умного дома Sber: https://partners.iot.sberdevices.ru/
. Обратите внимание, что для обращения к облаку Sber на сервере вендора должны быть установлены российские сертификаты.
Заголовки см. в разделе Заголовки запросов.
POST /v1/state
Тело запроса:
Поле | Тип | Обязательное? | Описание |
devices | dict<string, object> | ✔︎ | Устройства, состояние которых изменилось. Для каждого устройства передаются ID устройства в системе вендора и состояние его функций |
ID | string | ✔︎ | ID устройства в системе вендора |
states | list<object> | ✔︎ | Список состояний функций (см. Состояние устройства (state)) |
{
"devices": {
"id1": {
"states": [
{
"key": string,
"value": {
"type": string,
"type_value": object
}
},
{
// ...
}
]
}
}
}
Формат ответа
Умный дом Sber отправляет ответ на эндпоинт вендора. Заголовки см. в разделе Заголовки запросов.
Успешный ответ:
HTTP/1.1 200 OK