Dispozitive virtuale

Un dispozitiv virtual este un dispozitiv pe platforma HAM fără hardware. Măsurătorile lui vin din propriul dumneavoastră sistem prin API, nu de la un senzor HAM.

După aceea, dispozitivul virtual funcționează ca toate celelalte dispozitive: grafice, istoric, reguli, rapoarte și partajare.

Când îl folosiți

• Aveți un senzor sau un sistem de la alt producător și vreți valorile lui în aplicația HAM.
• Vreți reguli și notificări pentru valori pe care software-ul dumneavoastră le calculează.

Noțiuni de bază

Element	Valoare
Familie	v (Virtual HAM). Numărul de serie este, de exemplu, v:123.
Măsurători	Până la 6, cu codurile u0, u1, u2, u3, u4, u5
Ieșiri	Niciuna
Keep-alive	Niciunul. Dispozitivul se schimbă numai când trimiteți valori.

Aplicația nu are un ecran pentru crearea unui dispozitiv virtual. Pentru un dispozitiv virtual nou, contactați suportul.

Trimiteți valori

Trimiteți un POST către virtual_device_update.php. Aveți nevoie de permisiune de administrator pe dispozitiv.

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

Câmp	Conținut
serialno	Numărul de serie al dispozitivului virtual
R	Măsurătorile, cu codul drept cheie (u0 până la u5)
untime	Opțional. Momentul măsurătorii în secunde unix. Fără el, serverul folosește ora curentă.

Serverul păstrează numai câmpurile serialno, R și untime. Ignoră toate celelalte câmpuri.

Răspunsul este JSON cu messages și response.

Mesaj de eroare	Cauză
Invalid arguments	Lipsește serialno.
Invalid login	Cheia sau tokenul nu este corect.
Access denied to device	Nu aveți permisiune de administrator pe dispozitiv.

Citire

Citiți valorile în aceleași moduri ca pentru toate dispozitivele:

• API REST pentru starea curentă.
• Descărcați datele istorice pentru istoric.
• WebSocket pentru modificări în timp real.