HTTP Attendance API

مدخل HTTPS واحد لأي عميل ينتج حضورًا. تصادِق HTTP Attendance API بالرقم التسلسلي للجهاز والرمز، ثم تمرّر كل بصمة حضور معروفة إلى مسار التخزين والدفع إلى العميل نفسه الذي تعتمده كل محركات Cams الأصلية.

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

نظرة عامة

بوابة HTTPS مستقلة عن نوع الجهاز لاستقبال بصمات الحضور ونبضات الاتصال وفحوص الاشتراك من أي عميل.

HTTP Attendance API هي البوابة الأمامية المستقلة عن نوع الجهاز على المسار /api/attendance/v1/{op}. تصادِق كل طلب بترويسة الرقم التسلسلي للجهاز (sn) وترويسة auth-token، ثم تستقبل البيانات. وتتيح punch (حدث حضور واحد معروف) وheartbeat (حضور الجهاز) وvalidity (فحص الاشتراك) وconfig. وتمر بصمات الحضور إلى المسار المشترك، فيكون التخزين والدفع اللاحق إلى خادم العميل مطابقين لوسائل النقل الأصلية HTTP وTCP وMQTT — فتبقى التكاملات متسقة أيًّا كانت طريقة وصول الحضور.

APIRESTHTTPSJSONC++

مستخدمة في:المدارس والكليات والحرم الجامعي

POST /api/attendance/v1/punch

curl https://api.camsbiometrics.com/api/attendance/v1/punch \
  -H "sn: SN7A2300583" -H "auth-token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "user_id":"1001", "att_time":"2026-06-21 09:30:00",
        "att_state":1, "input_type":50 }'
# -> 200 {"ok":true}

الإمكانات

ماذا يفعل

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

أرسل بـ POST حدث حضور واحدًا معروفًا مع المستخدم والطابع الزمني وحالة IN/OUT ونوع المدخل والموقع الاختياري.

الإبلاغ عن التواجد

أرسل heartbeat لتعليم الجهاز متصلًا دون أي محتوى.

فحص الصلاحية

استعلم عما إذا كان اشتراك الحضور للجهاز نشطًا قبل إرسال البيانات.

مسار موحّد

تصل كل بصمة حضور إلى مسار التخزين والدفع نفسه الذي تعتمده وسائل الاستقبال الأصلية TCP وMQTT.

الميزات

كل شيء مشمول

مدخل HTTPS واحد لعملاء الحافة والتطبيقات والويب والهجين على /api/attendance/v1/{op}
مصادقة بالترويسات: الرقم التسلسلي للجهاز (sn) مع auth-token، مع التحقق من الاشتراك
تستقبل نقطة نهاية punch حدث حضور معروفًا (المستخدم والوقت وIN/OUT ونوع المدخل والموقع الجغرافي الاختياري)
تعلّم نقطة نهاية heartbeat الجهاز متصلًا لتتبّع التواجد
تعيد نقطة نهاية validity حالة الاشتراك الحالية قبل أن يرسل العميل البيانات
مسار مشترك: تخزين ودفع إلى خادم العميل مطابقان لما في المحركات الأصلية
عقد أخطاء JSON متسق للرقم التسلسلي المفقود أو الجهاز المجهول أو الرمز غير الصالح أو الاشتراك غير النشط
خلف nginx مع حدود لحجم المحتوى وتحديد للمعدّل

ابنِ مع HTTP Attendance API

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

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

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

أسئلة شائعة

ماذا تفعل HTTP Attendance API؟

هي البوابة الأمامية المستقلة عن نوع الجهاز التي تقبل بصمات الحضور المعروفة ونبضات الاتصال وفحوص الاشتراك، وتصادِقها بالرقم التسلسلي للجهاز والرمز، وتغذّي بها مسار حضور Cams المشترك.

كيف تُصادَق الطلبات؟

يحمل كل طلب ترويسة الرقم التسلسلي للجهاز (sn) وترويسة auth-token، ويجب أن تكون كلتاهما صالحتين. وتتطلب نقاط النهاية البيومترية بالإضافة إلى ذلك اشتراك حضور نشطًا.

هل يُعامَل الحضور عبر HTTP بالطريقة نفسها كما من الأجهزة؟

نعم. تمر بصمات الحضور إلى المسار نفسه الذي تستخدمه محركات HTTP وTCP وMQTT الأصلية، فيكون التخزين والدفع اللاحق متطابقين أيًّا كانت وسيلة النقل.