مقدمة

Cams Biometric Gateway — Web API 3.0

Cams Biometric Gateway هي واجهة Biometric API الشاملة التي تربط أي جهاز حضور بيومتري أو تحكم في الدخول بتطبيقك — نظام ERP أو الموارد البشرية HRMS أو الرواتب أو إدارة المدارس أو برمجيات مخصصة أو سير عمل أتمتة/ذكاء اصطناعي. تدعم جميع علامات الأجهزة الرئيسية وتوفر واجهة Biometric API موحّدة بصيغة JSON عبر HTTP أيًا كان العتاد.

38 عملية — 11 واجهة Callback (من الجهاز إلى الخادم) و27 واجهة RESTful (من الخادم إلى الجهاز). جميع البيانات المرسلة بصيغة JSON خام عبر HTTP/HTTPS.

جميع الأجهزة البيومترية مدعومة. أجهزة Cams، والأجهزة المعتمدة، والعلامات الأخرى (ZKTeco وSuprema وHikvision وAnviz وMorpho/IDEMIA وVirdi وMantra وNitgen وRealtime/Startek وBiomax وSecugen وeSSL وMatrix COSEC وغيرها). اختر وضع الاتصال المناسب لبيئتك.

كيف تعمل

تتكوّن Biometric Gateway من:

خادم البوابةمنصة سحابية تتضمن Cams Protocol Engine (ترجمة البروتوكولات، وتوحيد البيانات، والتخزين المؤقت عند عدم الاتصال، والمصادقة) وطبقة الواجهة الموحّدة التي توفر واجهة متسقة لتطبيقك.

Protocol Engineالمحرك الأساسي داخل خادم البوابة الذي يتواصل مع الأجهزة البيومترية، ويترجم البروتوكولات الخاصة بكل مصنّع، ويتولى تسجيل معاملات البيانات بشكل آمن وإدارة الهويات.

Protocol Engine Liteنسخة محلية يمكن تثبيتها على خادمك الخاص (Windows/Linux) للشبكات المحلية فقط أو البيئات المستضافة ذاتيًا. الواجهة نفسها، مع نشر محلي.

يتكامل مع

OdooERPNextSAPMicrosoft Dynamics ZohoBitrix24 OrangeHRMBayZatPalmHRuKnowva FedenaTeachmintEduBricz RazorPayPayruler n8nMakeZapier Claude (MCP)GeminiChatGPT تطبيقات ويب مخصصة

تطبيقك

ERP HRMS Payroll ERP للمدارس سير عمل بالذكاء الاصطناعي (n8n وZapier) MCP — Claude · Gemini · ChatGPT تطبيقات مخصصة

↑ واجهة Callback البوابة ← خادمك (دفع)

↓ واجهة RESTful خادمك ← البوابة (أوامر)

Biometric Gateway

Protocol Engine

معالجة آمنة للمصادقة تسجيل معاملات البيانات ترجمة البروتوكولات ذاكرة مؤقتة وطابور عند عدم الاتصال تشفير AES-256 · التحقق من رمز المصادقة

طبقة الواجهة الموحّدة

إدارة الهويات تكامل الذكاء الاصطناعي / MCP موزّع Callback موجّه أوامر REST توحيد البيانات · دعم بروتوكولات علامات متعددة

الإنترنت

البصمة · التعرّف على الوجه · وريد راحة اليد · بطاقة RFID · PIN · QR / الباركود · تتبّع GPS

الأجهزة البيومترية — جميع العلامات مدعومة

Cams ZKTeco Suprema Hikvision Anviz Morpho / IDEMIA Virdi Mantra Nitgen Realtime Biomax Secugen eSSL Matrix + الكثير غيرها

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

مقدمة

البدء

يتم التكامل في ثلاث خطوات. يحتاج خادمك إلى عنوان URL متاح للعموم لاستقبال استدعاءات Callback.

1

اضبط عنوان Callback URL

سجّل الدخول إلى بوابة API Monitor. اضبط عنوان HTTPS العام لخادمك كـ Callback URL لجهازك (أجهزتك). سيرسل محرك API الأحداث البيومترية إلى هذه النقطة بطلب POST لحظيًا.

2

استقبل بصمات الحضور

تستقبل نقطتك طلب POST بجسم JSON خام — دون معاملات استعلام في واجهات Callback. تحقق من AuthToken وحلّل بيانات البصمة ثم أرسل الرد {"status":"done"}.

3

استدعِ واجهات RESTful لإدارة المستخدمين والأجهزة

أرسل أمر JSON بطلب POST إلى عنوان RESTful endpoint المتوفر في حساب API Monitor الخاص بك، مع stgid (معرّف Service Tag) كمعامل استعلام. يضع المحرك الأمر في الطابور ويؤكد الجهاز استلامه خلال ~15 ثانية.

صيغة نقطة الاتصال

نوع الواجهة	الطريقة	كيفية الإرسال
واجهة Callback (واردة)	POST	يرسل الجهاز إلى العنوان الذي قمت بضبطه. جسم JSON خام؛ بلا معاملات.
واجهة RESTful (صادرة)	POST	ترسل POST إلى عنوان RESTful endpoint (الموجود في حساب API Monitor) مع `?stgid=YOUR_SERVICE_TAG_ID` وجسم JSON خام.

أجب دائمًا على طلبات Callback فورًا. يجب أن يعيد خادمك {"status":"done"} (HTTP 200) لتأكيد الاستلام. لا تُجرِ معالجة ثقيلة قبل الرد — ضعها في طابور.

التوثيق

توثيق واجهة API

المرجع مقسّم حسب الموضوع. ابدأ بتوافق الأجهزة، ثم عمليات Callback وREST.

الأجهزة المدعومة وأوضاع الاتصالالأجهزة التي تدعمها البوابة، وكيفية اتصال كل منها (Native Push أو Hybrid Push)، وعمليات API المتاحة في كل وضع. مرجع API: البنية والحقول ورموز الحالةاللبنات المشتركة بين جميع العمليات: تدفق الطلبات، وحقول JSON المشتركة، وأنواع القوالب، ورموز الحالة، والمنافذ، وتشفير البيانات. واجهات Callback: أحداث لحظية من الجهاز إلى خادمككل حدث يرسله الجهاز إلى عنوان Callback الخاص بك، مع بيانات JSON التي يستقبلها خادمك والرد الذي يجب أن يعيده. واجهات RESTful: أوامر من خادمك إلى الجهازالأوامر التي يرسلها خادمك إلى الجهاز عبر البوابة، مع JSON الطلب والاستجابة لكل أمر. اختبار واجهة API محليًاكيفية استقبال استدعاءات الجهاز على جهاز التطوير واختبار أوامر REST باستخدام Postman قبل النشر. مثال PHP: تخزين الحضور البيومتري في MySQLمعالج Callback بلغة PHP يعمل فعليًا ويخزّن بصمات الحضور في MySQL، في ثلاث خطوات. موجّهات مولّد الأكواد بالذكاء الاصطناعيانسخ موجّهًا إلى مساعد الذكاء الاصطناعي لديك لتوليد كود التكامل لبيئتك البرمجية. الأسئلة الشائعة وSDK والتكلفةأسئلة شائعة من المطورين، وكيفية عمل SDK وتسعير واجهة API.

معلومات إضافية

اتصل بنا

لدعم واجهة API أو توافق الأجهزة أو استفسارات المبيعات:

المبيعات والدعم

البريد الإلكترونيsales@camsbiometrics.com

واتساب+91-98-409-21006 (الدعم)

المبيعات+91-98-409-41006

موارد المطورين

المنتدىforum.camsbiometrics.com

الأجهزةdeveloper.camsbiometrics.com

المنتجاتcamsbiometrics.com/product

Cams Biometrics (Dheeram Innovations Pvt Ltd) — رقم: 2/98D، الطابق الثاني، مبنى Cams Biometrics، مقابل جامعة Satyabama، Semmancheri، OMR، Chennai – 600119، الهند.