الأجهزة الافتراضية

الجهاز الافتراضي جهاز على منصة HAM بدون عتاد. تأتي قراءاته من نظامك عبر الـ API، وليس من مستشعر HAM.

بعد ذلك، يعمل الجهاز الافتراضي مثل كل الأجهزة الأخرى: الرسوم البيانية والسجل والقواعد والتقارير والمشاركة.

متى تستخدمه

• لديك مستشعر أو نظام من مصنّع آخر وتريد قيمه في تطبيق HAM.
• تريد قواعد وإشعارات لقيم يحسبها برنامجك.

الأساسيات

العنصر	القيمة
العائلة	v (Virtual HAM). الرقم التسلسلي مثلًا v:123.
القراءات	حتى 6، بالرموز u0، u1، u2، u3، u4، u5
المخرجات	لا يوجد
Keep-alive	لا يوجد. يتغير الجهاز فقط عندما ترسل قيمًا.

لا توجد في التطبيق شاشة لإنشاء جهاز افتراضي. لجهاز افتراضي جديد، اتصل بالدعم.

إرسال القيم

أرسل طلب POST إلى virtual_device_update.php. تحتاج إلى إذن الإدارة على الجهاز.

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

الحقل	المحتوى
serialno	الرقم التسلسلي للجهاز الافتراضي
R	القراءات، حسب الرمز (u0 إلى u5)
untime	اختياري. وقت القياس بثواني unix. بدونه، يستخدم الخادم الوقت الحالي.

يحتفظ الخادم فقط بالحقول serialno وR وuntime. يتجاهل كل الحقول الأخرى.

الاستجابة JSON فيها messages وresponse.

رسالة الخطأ	السبب
Invalid arguments	serialno مفقود.
Invalid login	المفتاح أو الرمز غير صحيح.
Access denied to device	ليس لديك إذن الإدارة على الجهاز.

القراءة

تقرأ القيم بالطرق نفسها التي تستخدمها لكل الأجهزة:

• REST API للحالة الحالية.
• تنزيل البيانات التاريخية للسجل.
• WebSocket للتغييرات المباشرة.