Віртуальні пристрої

Віртуальний пристрій є пристроєм на платформі 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 для змін у реальному часі.

Чат із підтримкою