Состояние устройства (state)

Обновлено 14 марта 2025

Структура описывает текущее состояние функции устройства. Например, с помощью этой структуры можно описать, на каком уровне яркости сейчас светит лампа.

Структура используется:

• Когда вендор отправляет умному дому информацию о состоянии устройств пользователя:

  • при ответе вебхука на запрос Запрос состояния устройств (post query);
  • при отправке запроса Передача состояния устройств (post state).

• Когда умный дом отправляет вендору запрос Запрос изменения состояния устройства (post command).

• Когда умный дом отвечает вендору на запрос Получение состояния устройств (get state).

Поле	Тип	Обязательное?	Описание
key	string	✔︎	Название функции устройства (см. Функции устройств)
value	object	✔︎	Текущее значение функции (см. Значение функции устройства (value))

{
    "states": [
        {
            "key": string,
            "value": {
                "type": string,
                "type_value": object
            }
        },
        {
            // ...
        }
    ]
}

Пример описания состояния устройства

В примере описано устройство, работающее в цветном режиме.

{
    "states": [
        {
            "key": "light_mode",
            "value": {
                "type": "ENUM",
                "enum_value": "colour"
            }
        }
    ]
}