Virtualne naprave

Virtualna naprava je naprava na platformi HAM brez strojne opreme. Njeni odčitki prihajajo iz vašega sistema prek API, ne iz senzorja HAM.

Po tem virtualna naprava deluje kot vse druge naprave: grafi, zgodovina, pravila, poročila in skupna raba.

Kdaj jo uporabite

• Imate senzor ali sistem drugega proizvajalca in želite njegove vrednosti v aplikaciji HAM.
• Želite pravila in obvestila za vrednosti, ki jih izračuna vaša programska oprema.

Osnove

Element	Vrednost
Družina	v (Virtual HAM). Serijska številka je na primer v:123.
Odčitki	Do 6, s kodami u0, u1, u2, u3, u4, u5
Izhodi	Brez
Ohranjanje povezave	Brez. Naprava se spremeni samo, ko pošljete vrednosti.

Aplikacija nima zaslona za ustvarjanje virtualne naprave. Za novo virtualno napravo se obrnite na podporo.

Pošiljanje vrednosti

Pošljite POST na virtual_device_update.php. Potrebujete skrbniško dovoljenje za napravo.

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

Polje	Vsebina
serialno	Serijska številka virtualne naprave
R	Odčitki, po kodi (u0 do u5)
untime	Neobvezno. Čas meritve v unix sekundah. Brez njega strežnik uporabi trenutni čas.

Strežnik obdrži samo polja serialno, R in untime. Vsa druga polja prezre.

Odgovor je JSON z messages in response.

Sporočilo o napaki	Vzrok
Invalid arguments	serialno manjka.
Invalid login	Ključ ali žeton ni pravilen.
Access denied to device	Nimate skrbniškega dovoljenja za napravo.

Branje

Vrednosti berete na iste načine kot pri vseh napravah:

• REST API za trenutno stanje.
• Prenos zgodovinskih podatkov za zgodovino.
• WebSocket za spremembe v živo.