الرئيسية / المنتجات / واجهات API / Biometric Gateway Web API

API

Biometric Gateway Web API

تحوّل Biometric Gateway Web API (المعروفة أيضًا بـ Universal Biometric Web API 3.0) أي جهاز مدعوم للبصمة أو الوجه أو الكف أو الوريد أو القزحية أو الشبكية أو البطاقة أو كلمة المرور إلى نقطة نهاية متصلة بالسحابة يمكن لتطبيقك التخاطب معها من أي مكان في العالم. استقبل بصمات الحضور الفورية لحظة حدوثها وأدر المستخدمين على الجهاز عن بُعد، كل ذلك عبر عقد بسيط من REST وCallback.

ابدأ الآن وثائق المطورين

نظرة عامة

اربط أي جهاز حضور أو تحكم في الدخول بيومتري متصل بالإنترنت مباشرةً بتطبيق الويب لديك عبر HTTP — دون برنامج محلي أو حاسوب أو قاعدة بيانات.

تتيح Web API الرائدة من Cams التواصل من آلة إلى خادم بين الأجهزة البيومترية المثبّتة عن بُعد وتطبيق الخادم لديك. يتصل الجهاز بالإنترنت، ويُدفع الحضور إلى عنوان Callback (webhook) لديك في الوقت الفعلي، ويدير خادمك عمليات الجهاز مثل إضافة مستخدم أو حذفه، وإرسال القوالب، وإرسال الصور، وتحميل سجلات البصمات عبر استدعاءات RESTful. ولا حاجة إلى تثبيت برنامج سطح مكتب أو تشغيل قاعدة بيانات محلية أو إبقاء حاسوب على الشبكة المحلية. واجهة API مستقلة عن قاعدة البيانات وتعمل مع أي لغة خلفية.

APIRESTCallback/Webhook (HTTP POST)MQTT (مسار الاتصال الدائم عبر EMQX)PHPPythonJavaNode.js

مستخدمة في:إدارة الزوار الفعاليات والمهرجانات والملاعب

Callback (webhook) — بصمة حضور فورية

# Your Callback URL receives every punch in real time
POST https://yourapp.com/cams/callback
{
  "DeviceSN": "SN7A2300583",
  "EmployeeCode": "1042",
  "AttendanceLog": "2026-06-21 09:02:14",
  "Type": "face",
  "Direction": "CheckIn"
}

الإمكانات

ماذا يفعل

حضور في الوقت الفعلي

تُدفع بصمات الحضور إلى Callback URL لحظة تسجيلها على الجهاز.

إدارة المستخدمين عن بُعد

أضف المستخدمين واحذفهم واحظرهم وانقلهم وأرسل القوالب أو الصور إلى الأجهزة من خادمك عبر استدعاءات RESTful.

التقاط متعدد الأنماط

عقد واحد يتعامل مع مدخلات البصمة والوجه والكف والوريد والقزحية والشبكية والبطاقة وكلمة المرور.

المرونة دون اتصال

تُخزَّن بصمات الحضور دون اتصال مؤقتًا على الجهاز وتُعاد بالترتيب فور استعادة الاتصال.

نقل مشفّر

يمكن تفعيل تشفير البيانات الخام بـ AES-256 لكل جهاز لتبادل بيانات آمن.

الميزات

كل شيء مشمول

تسلّم Callback (webhook) API بصمات الحضور في الوقت الفعلي من الجهاز إلى خادمك دون تأخير الاستعلام الدوري
RESTful API لعمليات الخادم إلى الجهاز: Add User وAdd User with Templates وAdd User Photo وDelete User وDelete All Users وLoad Punchlog وغيرها (38 عملية)
تلتقط أنواع مدخلات متعددة لكل بصمة حضور: البصمة والوجه والبطاقة والكف ووريد الإصبع والقزحية والشبكية وكلمة المرور، إضافةً إلى مؤشري حرارة الجسم والكمامة حيث يدعمهما العتاد
تشمل أنواع بصمات الحضور CheckIn وCheckOut وBreakIn وBreakOut وOverTimeIn وOverTimeOut وMealIn وMealOut
تتعامل مع بصمات الحضور دون اتصال: تُرسَل البيانات المخزّنة بالتسلسل عند إعادة اتصال الجهاز
تشفير AES-256 اختياري لجميع البيانات الخام المتبادلة، بمفتاح أمان يُضبط في API Monitor
تتيح LoadLog API للتطبيقات غير الخادمية والمقتصرة على الشبكة المحلية سحب ما يصل إلى 30 يومًا من سجل الحضور عند الطلب
رموز حالة موثّقة لمعالجة قوية للأخطاء، مع AuthToken لكل جهاز وتتبّع OperationID للدعم والمطابقة

ابنِ مع Biometric Gateway Web API

احصل على مفتاح، واقرأ الوثائق، وأطلق. يساعدك فريقنا في أول تكامل لك.

تحدّث إلى مهندس WhatsApp

الأسئلة الشائعة

أسئلة شائعة

هل أحتاج إلى تثبيت أي برنامج على شبكتي المحلية لاستخدام Web API؟

لا. يجري التواصل عبر HTTP بين الجهاز وخادمك. ما دام الجهاز متصلًا بالإنترنت، يمكنك استقبال الحضور وإدارة المستخدمين دون أي برنامج أو قاعدة بيانات أو حاسوب محلي.

ما المدخلات البيومترية التي تدعمها Web API؟

البصمة والوجه والبطاقة والكف ووريد الإصبع والقزحية والشبكية وكلمة المرور، إضافةً إلى بيانات حرارة الجسم والكمامة حيث يوفرها العتاد.

ما الفرق بين Callback API وRESTful API؟

Callback API هي تواصل فوري من الجهاز إلى الخادم عبر عنوان URL تتيحه على خادمك (دون تأخير). أما RESTful API فهي تواصل من الخادم إلى الجهاز تستدعيه على endpoint لدى Cams لإدارة الجهاز، بتأخير يصل إلى نحو 15 ثانية.

هل يمكنني استخدام API إذا لم يكن لخادمي عنوان IP عام؟

نعم. استخدم LoadLog API لسحب سجلات الحضور لفترة زمنية محددة عند الطلب، ما دام الجهاز متصلًا بالإنترنت.