Виртуальные устройства

Виртуальное устройство это устройство на платформе HAM без оборудования. Его показания приходят из Вашей системы через API, а не от датчика HAM.

После этого виртуальное устройство работает как все другие устройства: графики, история, правила, отчёты и совместный доступ.

Когда его использовать

У Вас есть датчик или система другого производителя, и Вы хотите видеть их значения в приложении HAM.
Вам нужны правила и уведомления для значений, которые рассчитывает Ваша программа.

Основы

Пункт	Значение
Семейство	`v` (Virtual HAM). Серийный номер, например, `v:123`.
Показания	До 6, с кодами `u0`, `u1`, `u2`, `u3`, `u4`, `u5`
Выходы	Нет
Keep-alive	Нет. Устройство меняется, только когда Вы отправляете значения.

В приложении нет экрана для создания виртуального устройства. Для нового виртуального устройства обратитесь в поддержку.

Отправка значений

Отправьте POST на virtual_device_update.php. Вам нужно право администратора на устройство.

curl -X POST https://api.hamsystems.eu/virtual_device_update.php \
  -H "Authorization: Bearer-API YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serialno": "v:123", "R": {"u0": 2150, "u1": 48}}'

Поле	Содержимое
`serialno`	Серийный номер виртуального устройства
`R`	Показания, по кодам (от `u0` до `u5`)
`untime`	Необязательно. Время измерения в секундах unix. Без него сервер использует текущее время.

Сервер сохраняет только поля serialno, R и untime. Все другие поля он не учитывает.

Ответ это JSON с messages и response.

Сообщение об ошибке	Причина
`Invalid arguments`	Нет `serialno`.
`Invalid login`	Ключ или токен неправильный.
`Access denied to device`	У Вас нет права администратора на устройство.

Чтение

Значения Вы читаете так же, как для всех устройств:

REST API для текущего состояния.
Загрузка исторических данных для истории.
WebSocket для изменений в реальном времени.

Чат с поддержкой