Virtuele apparaten

Een virtueel apparaat is een apparaat op het HAM-platform zonder hardware. De metingen komen uit uw eigen systeem via de API, niet van een HAM-sensor.

Daarna werkt het virtuele apparaat zoals alle andere apparaten: grafieken, geschiedenis, regels, rapporten en delen.

Wanneer u het gebruikt

U hebt een sensor of een systeem van een andere fabrikant en u wilt de waarden ervan in de HAM-app.
U wilt regels en meldingen voor waarden die uw eigen software berekent.

Basis

Item	Waarde
Familie	`v` (Virtual HAM). Het serienummer is bijvoorbeeld `v:123`.
Metingen	Maximaal 6, met de codes `u0`, `u1`, `u2`, `u3`, `u4`, `u5`
Uitgangen	Geen
Keep-alive	Geen. Het apparaat verandert alleen wanneer u waarden stuurt.

De app heeft geen scherm om een virtueel apparaat te maken. Neem voor een nieuw virtueel apparaat contact op met ondersteuning.

Waarden sturen

Stuur een POST naar virtual_device_update.php. U hebt beheerdersrechten op het apparaat nodig.

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

Veld	Inhoud
`serialno`	Het serienummer van het virtuele apparaat
`R`	De metingen, met de code als sleutel (`u0` tot `u5`)
`untime`	Optioneel. De tijd van de meting in unix-seconden. Zonder dit veld gebruikt de server de huidige tijd.

De server bewaart alleen de velden serialno, R en untime. Hij negeert alle andere velden.

Het antwoord is JSON met messages en response.

Foutbericht	Oorzaak
`Invalid arguments`	`serialno` ontbreekt.
`Invalid login`	De sleutel of het token is niet juist.
`Access denied to device`	U hebt geen beheerdersrechten op het apparaat.

Lezen

U leest de waarden op dezelfde manieren als voor alle apparaten:

REST API voor de huidige status.
Historische gegevens downloaden voor de geschiedenis.
WebSocket voor live wijzigingen.

Chat met support