Virtuální zařízení

Virtuální zařízení je zařízení na platformě HAM bez hardwaru. Jeho měření pocházejí z vašeho systému přes API, ne ze senzoru HAM.

Potom virtuální zařízení funguje jako všechna ostatní zařízení: grafy, historie, pravidla, reporty a sdílení.

Kdy ho použít

• Máte senzor nebo systém jiného výrobce a chcete jeho hodnoty v aplikaci HAM.
• Chcete pravidla a upozornění pro hodnoty, které počítá váš vlastní software.

Základní údaje

Položka	Hodnota
Rodina	v (Virtual HAM). Sériové číslo je například v:123.
Měření	Až 6, s kódy u0, u1, u2, u3, u4, u5
Výstupy	Žádné
Udržení spojení	Žádné. Zařízení se mění jen tehdy, když pošlete hodnoty.

Aplikace nemá obrazovku pro vytvoření virtuálního zařízení. Pro nové virtuální zařízení kontaktujte podporu.

Odeslání hodnot

Pošlete POST na virtual_device_update.php. Potřebujete oprávnění správce zařízení.

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}}'

Pole	Obsah
serialno	Sériové číslo virtuálního zařízení
R	Měření podle kódu (u0 až u5)
untime	Volitelné. Čas měření v sekundách unixového času. Bez něj server použije aktuální čas.

Server uchová jen pole serialno, R a untime. Všechna ostatní pole ignoruje.

Odpověď je JSON s poli messages a response.

Chybová zpráva	Příčina
Invalid arguments	Chybí serialno.
Invalid login	Klíč nebo token není správný.
Access denied to device	Nemáte oprávnění správce zařízení.

Čtení

Hodnoty čtete stejnými způsoby jako u všech zařízení:

• REST API pro aktuální stav.
• Stažení historických dat pro historii.
• Živá data (WebSocket) pro živé změny.