عقد واحد لكل الأجهزة. 38 عملية في خمس مجموعات من الإمكانات، متاحة كاستدعاءات REST متزامنة وwebhooks Callback في الوقت الفعلي.
تُنفَّذ جميع استدعاءات REST على مضيف واحد ذي إصدار محدد.
https://api.camsbiometrics.com/v3/
يحمل كل طلب AuthToken مقيّدًا بحسابك وجهازك. تُصدَر المفاتيح من بوابة المطورين.
طلبات بترميز النماذج أو JSON. الاستجابات بصيغة JSON بحقول ورموز أخطاء يمكن التنبؤ بها.
طريقتان للتكامل
تستدعي البوابة وتحصل على إجابة فورية. مثالي لجلب الحضور وعرض المستخدمين وتسجيل شخص أو فتح باب عند الطلب.
سجّل عنوان URL فتدفع إليك البوابة الأحداث لحظة إبلاغ الجهاز بها — دون استعلام دوري، مع إعادة محاولة تلقائية عند الفشل.
العمليات
مجمّعة بحسب وظيفتها. تطابق الأسماء نقاط نهاية البوابة الأساسية 1:1.
جميع بصمات الحضور ضمن نطاق تاريخ عبر الحساب.
سجلات موظف واحد بحسب رمزه خلال فترة.
البصمات التي التقطها جهاز واحد بحسب رقمه التسلسلي.
ملخص لكل يوم ولكل موظف (دخول/خروج، ساعات).
زوج أول دخول / آخر خروج لكل موظف في كل يوم.
لقطة مباشرة لبصمات اليوم.
الصور الملتقطة المرفقة بالبصمة، حيثما كان ذلك مدعومًا.
تصدير مجمّع للرواتب والمطابقة.
إنشاء مستخدم على جهاز واحد أو أكثر.
تعديل الاسم أو الدور أو الصلاحية الزمنية أو الامتيازات.
إزالة مستخدم من جهاز.
البحث عن مستخدم بحسب الرمز، مع بيانات اعتماد اختيارية.
عرض كل المسجّلين على جهاز.
إظهار الأجهزة التي يوجد عليها المستخدم.
إرسال قالب بصمة إلى الجهاز.
تسجيل قالب وجه حيثما كان ذلك مدعومًا.
إسناد بطاقة RFID / قربية إلى مستخدم.
تعيين أو تغيير رمز PIN / كلمة مرور الجهاز.
استنساخ المستخدمين والقوالب بين الأجهزة.
إعادة تسليم بيانات مستخدم إلى قائمة انتظار الجهاز.
تشغيل مرحّل باب أو بوابة دوّارة أو ضلفة أو حاجز مرجحن أو ذراعي في الوقت الفعلي.
قفل / تثبيت باب تحت سيطرتك.
قراءة الحالة الحالية: مفتوح / مغلق.
تحديد نوافذ دخول زمنية.
سجل أحداث الدخول / الخروج والأبواب.
جرد بكل جهاز متصل.
الطراز والبرنامج الثابت والسعة والعدّادات.
حالة الاتصال وآخر ظهور وعمق قائمة الانتظار.
تأكيد إمكانية الوصول إلى الجهاز الآن.
مواءمة ساعة الجهاز مع الخادم.
إعادة تشغيل جهاز عن بُعد.
مسح الأوامر العالقة من قائمة الانتظار.
تتبّع حالة أمر في قائمة الانتظار.
الاشتراك بعنوان URL لـ webhook لتلقي الأحداث المباشرة.
يُطلَق مع كل بصمة حضور في الوقت الفعلي.
انتقالات الاتصال / عدم الاتصال والحالة الصحية.
تأكيد عند وصول قالب إلى الجهاز.
تتبّع تقدّم الترحيل المجمّع للأجهزة / البيانات.
استجابات يمكن التنبؤ بها
| الرمز | المعنى | ماذا تفعل |
|---|---|---|
200 | نجاح | عالج حمولة JSON. |
401 | AuthToken غير صالح أو مفقود | تحقق من مفتاح API وإقران الجهاز. |
404 | الجهاز أو المستخدم غير موجود | تحقق من الرقم التسلسلي / رمز الموظف. |
409 | الجهاز غير متصل / في قائمة الانتظار | الأمر في قائمة الانتظار؛ استعلم عن GetCommandStatus دوريًا. |
429 | تجاوز حد المعدّل | تمهّل وأعد المحاولة مع تأخير عشوائي (jitter). |
يرشدك دليل البدء السريع من مفتاح API إلى أول سجل حضور خلال دقائق.
نستخدم ملفات تعريف الارتباط لقياس حركة الزيارات وتحسين BiometricAPI.com. تبقى التحليلات متوقفة إلى أن توافق. اعرف المزيد.