Virtuelle enheder

En virtuel enhed er en enhed på HAM-platformen uden hardware. Dens målinger kommer fra dit eget system via API’et, ikke fra en HAM-sensor.

Derefter virker den virtuelle enhed som alle andre enheder: grafer, historik, regler, rapporter og deling.

Hvornår du skal bruge den

Du har en sensor eller et system fra en anden producent, og du vil have dens værdier i HAM-appen.
Du vil have regler og notifikationer for værdier, som din egen software beregner.

Grundlæggende

Element	Værdi
Familie	`v` (Virtual HAM). Serienummeret er for eksempel `v:123`.
Målinger	Op til 6 med koderne `u0`, `u1`, `u2`, `u3`, `u4`, `u5`
Udgange	Ingen
Keep-alive	Ingen. Enheden ændrer sig kun, når du sender værdier.

App’en har ingen skærm til at oprette en virtuel enhed. Kontakt support for en ny virtuel enhed.

Send værdier

Send en POST til virtual_device_update.php. Du skal have administratortilladelse til enheden.

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

Felt	Indhold
`serialno`	Den virtuelle enheds serienummer
`R`	Målingerne med koden som nøgle (`u0` til `u5`)
`untime`	Valgfri. Tidspunktet for målingen i unix-sekunder. Uden det bruger serveren det aktuelle tidspunkt.

Serveren beholder kun felterne serialno, R og untime. Den ignorerer alle andre felter.

Svaret er JSON med messages og response.

Fejlmeddelelse	Årsag
`Invalid arguments`	`serialno` mangler.
`Invalid login`	Nøglen eller tokenet er ikke korrekt.
`Access denied to device`	Du har ikke administratortilladelse til enheden.

Læs

Du læser værdierne på de samme måder som for alle enheder:

REST API for den aktuelle tilstand.
Download historiske data for historikken.
WebSocket for ændringer i realtid.

Chat med support