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

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

След това виртуалното устройство работи като всички други устройства: графики, история, правила, отчети и споделяне.

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

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

Основи

Елемент	Стойност
Фамилия	`v` (Virtual HAM). Серийният номер е например `v:123`.
Измервания	До 6, с кодовете `u0`, `u1`, `u2`, `u3`, `u4`, `u5`
Изходи	Няма
Сигнал за активност	Няма. Устройството се променя само когато изпратите стойности.

Приложението няма екран за създаване на виртуално устройство. За ново виртуално устройство се свържете с поддръжката.

Изпращане на стойности

Изпратете 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 за промените на живо.

Чат с поддръжката