1. يُرسل البرنامج الوسيط طلب POST إلى الرابط أعلاه، مع إضافة المفتاح في الترويسة X-Attendance-Key.
2. صيغة كل عملية هي device_id وemployee_id وevent_type (in أو out) وoccurred_at بالتاريخ والوقت المحلي.
3. يمكن إرسال عملية واحدة أو قائمة حتى 100 عملية؛ ويطابق النظام رقم الموظف مع رقم الموظف المسجل داخله.
4. اختبار الجهاز يتحقق من الوصول إلى عنوان الشبكة والمنفذ فقط. مزامنة بروتوكول الشركة المصنعة تتم بواسطة SDK أو برنامج الربط الخاص بها.

POST /api/integrations/events
X-Attendance-Key: <integration-key>
Content-Type: application/json

{
  "device_id": "F22-RIYADH-01",
  "employee_id": "1001",
  "event_type": "in",
  "occurred_at": "2026-08-30T08:15:00"
}