Apparati virtwali
Apparat virtwali huwa apparat fil-pjattaforma HAM mingħajr hardware. Il-qari tiegħu jiġi mis-sistema tagħkom permezz tal-API, mhux minn senser HAM.
Wara dan, l-apparat virtwali jaħdem bħall-apparati l-oħra kollha: graffs, storja, regoli, rapporti u qsim.
Meta tużawh
Taqsima "Meta tużawh"- Għandkom senser jew sistema minn manifattur ieħor u tridu l-valuri tiegħu fl-app HAM.
- Tridu regoli u notifiki għal valuri li jikkalkula s-software tagħkom.
Bażi
Taqsima "Bażi"| Oġġett | Valur |
|---|---|
| Familja | v (Virtual HAM). In-numru tas-serje huwa, pereżempju, v:123. |
| Qari | Sa 6, bil-kodiċijiet u0, u1, u2, u3, u4, u5 |
| Outputs | Xejn |
| Keep-alive | Xejn. L-apparat jinbidel biss meta tibagħtu l-valuri. |
L-app m’għandhiex skrin biex toħolqu apparat virtwali. Għal apparat virtwali ġdid, ikkuntattjaw is-support.
Ibagħtu l-valuri
Taqsima "Ibagħtu l-valuri"Ibagħtu POST lil virtual_device_update.php. Għandkom bżonn permess admin fuq l-apparat.
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}}'| Qasam | Kontenut |
|---|---|
serialno |
In-numru tas-serje tal-apparat virtwali |
R |
Il-qari, skont il-kodiċi (u0 sa u5) |
untime |
Fakultattiv. Il-ħin tal-kejl f’sekondi unix. Mingħajru, is-server juża l-ħin attwali. |
Is-server iżomm biss l-oqsma serialno, R u untime. Jinjora l-oqsma l-oħra kollha.
It-tweġiba hija JSON b’messages u response.
| Messaġġ ta’ żball | Kawża |
|---|---|
Invalid arguments |
serialno huwa nieqes. |
Invalid login |
Iċ-ċavetta jew it-token mhumiex korretti. |
Access denied to device |
M’għandkomx permess admin fuq l-apparat. |
Qari
Taqsima "Qari"Taqraw il-valuri bl-istess modi bħall-apparati l-oħra kollha:
- REST API għall-istat attwali.
- Niżżlu data storika għall-istorja.
- WebSocket għall-bidliet live.

