Виртуелни уређаји

Виртуелни уређај је уређај на 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 за промене уживо.

Ћаскање са подршком