Support Hub/API & Integrations/المقارنة بين Webhooks والاستطلاع: كيف يجب أن تصل بيانات…
Translated from the English article and reviewed by a person. Read the English original
Developer

المقارنة بين Webhooks والاستطلاع: كيف يجب أن تصل بيانات القياسات الحيوية في الوقت الفعلي إلى خادمك

المقارنة بين Webhooks والاستطلاع: كيف يجب أن تصل بيانات القياسات الحيوية في الوقت الفعلي إلى خادمك

كل تكامل للقياسات الحيوية يجب أن يجيب عن سؤال أساسي: كيف يتحول مسح عند الباب إلى سجل في نظامك؟ هناك طريقتان لذلك. يمكن لخادمك أن يستمر في سؤال الجهاز عما إذا حدث أي شيء جديد، وهذا هو الاستطلاع (polling). أو يمكن للنظام أن يُخبر خادمك في اللحظة التي يحدث فيها الشيء، وهذا هو الـ webhook. بالنسبة لبيانات الحضور والوصول القائمة على القياسات الحيوية، يؤثر الاختيار بين webhooks والاستطلاع على مدى حداثة بياناتك، وحجم الحمل الذي تفرضه على الأجهزة والشبكات، ومدى موثوقية سجلاتك. يشرح هذا الدليل الطريقتين بلغة بسيطة، ويوضح لماذا تُعد webhooks الخيار الافتراضي الأفضل لبيانات القياسات الحيوية، ويغطي كيفية بناء مستقبِل webhook موثوق، ويبين أين ما زال للاستطلاع مكان.

01 · السحب مقابل الدفع

طريقتان لانتقال البيانات

تخيل أنك تنتظر طردًا مهمًا. يمكنك أن تذهب إلى الباب الأمامي كل خمس دقائق للتحقق من وصوله. أو يمكنك انتظار رنين جرس الباب. كلتا الطريقتين ستوصلك إلى الطرد. الأولى تهدر كثيرًا من الرحلات وما زالت تتركك متأخرًا حتى خمس دقائق. أما الثانية فتخبرك في اللحظة التي يصل فيها الطرد.

هذا هو الفرق بين polling وwebhooks.

الاستطلاع: خادمك يستمر في السؤال

خادمك

يسأل: هل هناك مسحات جديدة منذ المرة الأخيرة؟

→

الجهاز أو النظام

يرد: لا يوجد جديد

→

انتظار

النوم لمدة فترة الاستطلاع

→

تكرار

السؤال مرة أخرى وأخرى طوال اليوم

Webhook: النظام يُخبر خادمك

مسح الموظف

مسح بصمة أو وجه أو بطاقة تم التحقق منه

→

Gateway

يرسل الحدث إلى عنوان URL الخاص بالـ webhook فورًا

→

خادمك

يستقبل الحدث ويرد بـ done

→

Done

لا انتظار ولا طلبات مهدرة

الاستطلاع Webhooks
من يبدأ الحوار خادمك النظام الذي يملك البيانات
عند وصول البيانات عند الاستطلاع التالي، متأخرة بما يصل إلى فترة كاملة فورًا بعد المسح
الطلبات عندما لا يحدث شيء مستمرة، ومعظمها فارغ لا يوجد
الحمل على الأجهزة والشبكة ثابت، بغض النظر عن النشاط فقط عند وجود شيء للإرسال
مدى التعقيد بالنسبة لك تتبع ما تم جلبه بالفعل استقبال الأحداث والإقرار باستلامها

02 · التكاليف الخفية

لماذا يعاني الاستطلاع مع بيانات القياسات الحيوية

يعمل الاستطلاع جيدًا مع البيانات التي تتغير ببطء أو حيث لا يهم التأخير. أما بيانات الحضور والوصول القائمة على القياسات الحيوية فهي عكس ذلك تمامًا. إذ تُنتج في دفعات حادة عند بداية الوردية ونهايتها، وتكون هادئة معظم بقية الوقت، وغالبًا ما تكون مطلوبة فورًا.

التأخير متأصل في الطريقة

مع الاستطلاع، يساوي أسوأ تأخير دائمًا فترة الاستطلاع. فالمسح الذي يحدث بعد ثانية واحدة من استطلاع ما ينتظر الفترة كاملة قبل أن يراه خادمك.

فترة الاستطلاع أسوأ تأخير قبل أن يعلم نظامك كافٍ لـ
كل 24 ساعة حتى يوم كامل كشوف الرواتب الشهرية فقط
كل ساعة حتى 60 دقيقة التقارير اليومية
كل 5 دقائق حتى 5 دقائق معظم لوحات المتابعة، وليس التنبيهات
كل دقيقة حتى 60 ثانية قريب من الوقت الفعلي، بتكلفة طلبات عالية
Webhook لا يوجد تأخير استطلاع لوحات المتابعة المباشرة والإشعارات والأتمتة

معظم الطلبات مهدرة

للاقتراب من الوقت الفعلي، تحتاج إلى الاستطلاع بوتيرة أعلى. لكن معظم هذه الطلبات لا تعيد شيئًا. استطلاع جهاز واحد كل دقيقة يعني 1,440 طلبًا لكل جهاز يوميًا. وعلى 50 جهازًا، يصبح ذلك 72,000 طلب يوميًا، معظمها يطرح سؤالًا إجابته “لا شيء جديد.” كل واحد من هذه الطلبات يستهلك سعة الشبكة ووقت معالجة الجهاز.

تتبع ما تم جلبه يصبح هشًا

يجب أن يتذكر تكامل الاستطلاع ما سبق جلبه، وغالبًا عن طريق تخزين وقت أو موضع آخر سجل رآه. إذا كانت هذه العلامة خاطئة، بسبب إعادة تشغيل، أو فرق في الساعة بين الخادم والجهاز، أو سجلات خُزنت أثناء انقطاع الجهاز، فإن التكامل إما يفوّت عمليات المسح أو يستوردها مرتين. هذه المشكلات صامتة، وغالبًا ما تظهر فقط أثناء نزاع يتعلق بالرواتب.

يصبح الأمر أصعب مع كل موقع

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

الاستطلاع يطرح السؤال نفسه آلاف المرات في اليوم ليلتقط اللحظات القليلة المهمة. أما webhooks فلا تتكلم إلا عندما يحدث شيء فعلًا.

03 · التسليم بالدفع مع Cams

كيف تعمل Webhooks للقياسات الحيوية

مع Cams Biometrics Gateway، يُسمى تسليم الـ webhook Callback API. تزود الـ Gateway بعنوان URL على خادمك، وترسل كل عملية مسح تم التحقق منها إلى هذا العنوان فور حدوثها. تُسلَّم أحداث Callback بلا تأخير تقريبًا للأجهزة المعتمدة على Native Push.

ما الذي يستقبله خادمك

Callback API، طلب يرسله Gateway إلى عنوان URL الخاص بالـ webhook

{
  "RealTime": {
    "OperationID": "9nu1wak5616p",
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "PunchLog": {
      "Type": "CheckOut",
      "Temperature": "36.8",
      "FaceMask": false,
      "InputType": "Fingerprint",
      "UserId": "2",
      "LogTime": "2020-09-17 07:48:22 GMT +0530"
    },
    "AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 04:19:03 GMT +0000"
  }
}
الحقل ما الذي يخبر به خادمك
OperationID مرجع فريد لهذا الحدث
LabelName اسم الموقع أو الباب الذي أُسند إليه الجهاز
SerialNumber الجهاز المحدد الذي سجّل المسح
Type هل كان تسجيل دخول أم تسجيل خروج
InputType كيف تحقق الشخص من هويته: بصمة، أو وجه، أو بطاقة، أو رمز PIN، وغير ذلك
UserId من قام بالمسح، بما يطابق المعرّف في نظام الموارد البشرية لديك
LogTime متى حدث المسح على الجهاز، مع فارق المنطقة الزمنية
AuthToken الرمز الذي يستخدمه خادمك للتأكد من أن الطلب صحيح
Time الطابع الزمني للرسالة نفسها، بتوقيت GMT

ما الذي يجب أن يرسله خادمك

بمجرد أن يستقبل خادمك الحدث، يرد بإقرار قصير. هذا يُبلغ الـ Gateway بأن الحدث وصل بأمان.

Callback API، الاستجابة التي يجب أن يعيدها الـ webhook الخاص بك

{ "status": "done" }

دفع حتى عندما لا يستطيع الجهاز ذلك

ليست كل الأجهزة قادرة على دفع البيانات بمفردها. بعض الأجهزة القديمة أو غير المعتمدة تخزن سجلات الحضور فقط في قاعدة بيانات محلية أو ملف. مع Cams Hybrid Push، يمكن للـ Gateway القراءة من تلك القاعدة (DB Pull) أو مراقبة ذلك الملف (File Processing)، ومع ذلك تسليم سجلات الحضور الجديدة إلى عنوان Callback URL الخاص بك. يحصل خادمك على التسليم بالدفع في كلتا الحالتين، حتى لو كان الجهاز الأساسي يحتاج عادةً إلى الاستطلاع.

04 · أفضل الممارسات

بناء مستقبِل webhook موثوق

مستقبِل الـ webhook سهل البناء، لكن بضع ممارسات تصنع الفرق بين مستقبِل يعمل في الاختبار وآخر يعمل كل يوم لسنوات.

الممارسة ما الذي يجب فعله لماذا هي مهمة
الإقرار أولًا أرسل الرد بالحالة done فور استلام الحدث، ثم نفّذ الأعمال الأبطأ لاحقًا يُبقي طلب الـ Gateway قصيرًا، حتى لو كانت أنظمتك اللاحقة بطيئة
ضع العمل في طابور ضع كل حدث مستلم في طابور أو جدول، ثم عالجه بشكل منفصل يتعامل مع الدفعات عند بداية الوردية دون فقدان الأحداث
تحقق من AuthToken تحقق من الرمز في كل طلب قبل الوثوق بالبيانات يمنع أي شخص آخر من إرسال حضور مزيف إلى عنوان URL الخاص بك
استخدم HTTPS اجعل الـ webhook متاحًا فقط عبر HTTPS، مع تشفير AES-256 اختياري من الـ Gateway بيانات الحضور بيانات شخصية ويجب حمايتها أثناء النقل
اجعله idempotent استخدم OperationID لاكتشاف الأحداث التي عالجتها بالفعل وتجاهلها التسليم المتكرر لا يتحول أبدًا إلى سجل حضور مكرر
اعتمد LogTime للحضور سجّل الحضور باستخدام LogTime، لا بوقت استلام خادمك للحدث الأحداث المخزنة أثناء انقطاع الخدمة تصل لاحقًا لكنها تحتفظ بوقت المسح الحقيقي
رتّب حسب LogTime رتّب الأحداث حسب LogTime قبل حساب الساعات قد تصل الأحداث المخزنة مؤقتًا خارج الترتيب بعد انقطاع الاتصال
سجّل كل شيء احتفظ بسجل لكل حدث مستلم ولكل استجابة أُرسلت يجعل استكشاف الأخطاء والتدقيق أمرًا مباشرًا

خطّط للدفعات، لا للمتوسطات

قد يستقبل موقع فيه 300 موظف شيئًا يكاد يكون معدومًا معظم اليوم، ثم 300 حدث خلال عشر دقائق عند تغيير الوردية. صمّم المستقبِل لهذه الذروة. الإقرار السريع ووضع العمل في طابور هما أبسط طريقة للتعامل معها.

أين يمكن أن يعيش الـ webhook

يحتاج الـ webhook الخاص بك إلى عنوان HTTPS عام يمكن للـ Gateway الوصول إليه. قد يكون ذلك نقطة نهاية داخل تطبيقك، أو دالة سحابية صغيرة، أو webhook وارد في أداة أتمتة مثل n8n أو Make. أجهزتك نفسها لا تحتاج إلى IP عام. ويمكن للمواقع خلف جدران الحماية الاتصال بالـ Gateway عبر Hybrid Connector، الذي يعمل عبر اتصال صادر.

نظامك يقرر ما يحدث بعد ذلك

يسلّم الـ Gateway الأحداث المتحقق منها وينتظر إقرارك. أما ما يحدث بعد ذلك، مثل الكتابة إلى نظام الموارد البشرية HRMS، أو تحديث لوحة متابعة، أو إرسال إشعار بالتأخير، أو بدء سير عمل، فيحدده برنامجك وقواعدك الخاصة.

05 · استخدام الطريقتين معًا

أين ما زال للاستطلاع مكان

يجب أن تكون webhooks الخيار الافتراضي لبيانات القياسات الحيوية المباشرة. لكن جلب البيانات عند الطلب ما زال له مهام نافعة ومحددة. أقوى التكاملات تستخدم webhooks للتسليم في الوقت الفعلي، وعمليات جلب عند الطلب بين حين وآخر للتحقق والاستعادة.

الموقف أفضل نهج السبب
الحضور المباشر، واللوحات، والإشعارات Webhooks (Callback API) تصل البيانات في اللحظة التي يحدث فيها المسح
كان خادمك غير متصل لفترة اجلب السجلات عند الطلب لسد أي فجوة والتأكد من عدم فقدان شيء
المطابقة الليلية أو الأسبوعية اجلب السجلات وفق جدول زمني للمقارنة مع ما سلّمته webhooks، كشبكة أمان
إعداد تكامل جديد اجلب السجلات التاريخية مرة واحدة استيراد السجل الحالي قبل أن تتولى webhooks العمل
تدقيق فترة محددة اجلب السجلات لتلك الفترة لإنتاج سجل كامل للمراجعة

لهذه المهام، تتضمن Cams RESTful API عمليات لتحميل السجلات من الأجهزة. فجلب السجلات عند الحاجة وبشكل مقصود يكمل webhooks ولا ينافسها. الفرق في النية: أنت تجلب عندما يكون لديك سبب، بدلًا من السؤال كل دقيقة احتياطًا.

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

هل يكون الاستطلاع أفضل من webhooks لبيانات القياسات الحيوية في أي وقت؟

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

ماذا يحدث للمسحات إذا كان خادم الـ webhook الخاص بي متوقفًا؟

إذا كان خادم الـ webhook الخاص بك متوقفًا، فستُخزَّن بيانات الحضور في طابور Cams. وبمجرد عودة خادمك إلى العمل، ستُدفع السجلات الموجودة في الطابور تلقائيًا إلى خادمك. يُعاد تشغيل الطابور تلقائيًا مرة كل 3 ساعات، ويمكنك أيضًا إعادة تشغيله يدويًا في أي وقت من Cams Portal. هذا يضمن عدم فقدان سجلات الحضور بسبب توقف مؤقت للخادم.

هل تحتاج أجهزة القياسات الحيوية الخاصة بي إلى IP عام لكي تعمل webhooks؟

لا. يجب أن يكون عنوان URL الخاص بالـ webhook قابلًا للوصول من الـ Gateway، لكن أجهزتك لا تحتاج إلى ذلك. ويمكن للمواقع التي لا تملك IP عامًا الاتصال عبر Hybrid Connector، الذي يستخدم اتصالًا صادرًا.

هل يمكنني استقبال webhooks في n8n أو Make أو Zapier؟

نعم. أي أداة تستطيع استقبال webhook وارد يمكنها استقبال أحداث Cams Callback. ويمكن لـ n8 وMake أيضًا إرجاع إقرار done المطلوب مباشرةً. قد يحتاج Zapier إلى وسيط صغير أمامه لإرسال ذلك الرد.

لماذا تختلف LogTime وTime في الحمولة؟

LogTime هو الوقت الذي مسح فيه الشخص فعليًا، ويُسجَّل مع فارق المنطقة الزمنية للجهاز. أما Time فهو الطابع الزمني للرسالة نفسها، بتوقيت GMT. إذا كان الجهاز غير متصل، فقد تُرسل الرسالة بعد وقت طويل من المسح. استخدم LogTime دائمًا للحضور.

الخاتمة: دع جرس الباب يرن

كان الاستطلاع منطقيًا عندما لم يكن بالإمكان قراءة أجهزة القياسات الحيوية إلا عند الطلب، ولم يكن أحد يتوقع أن تكون بيانات الحضور مباشرة. أما اليوم، فإن لوحات الموارد البشرية، وأنظمة الرواتب، وأدوات الأتمتة، ومساعدو الذكاء الاصطناعي، جميعها تعمل بأفضل شكل مع البيانات لحظة وجودها. إن طرح السؤال نفسه على جهاز آلاف المرات في اليوم طريقة بطيئة ومهدرة للوصول إلى ذلك.

تحوّل webhooks كل مسح متحقق منه إلى حدث تستقبله أنظمتك فورًا، دون طلبات مهدرة ودون تتبع هش لما سبق جلبه. احتفظ بجلب السجلات عند الطلب لما يجيده، أي سد الفجوات والتحقق من الاكتمال، ودع webhooks تحمل كل شيء آخر.

صُمم Cams Biometrics Gateway حول التسليم بالدفع. تُرسل Callback API الخاصة به كل مسح متحقق منه إلى webhook الخاص بك في الوقت الفعلي، من أجهزة تنتمي إلى أكثر من 15 علامة تجارية، وبتنسيق JSON موحد. وتوفر أوضاع Hybrid Push تسليم أحداث الدفع حتى من الأجهزة التي لا تستطيع الدفع بمفردها، بينما توفر RESTful API عمليات عند الطلب مثل تحميل السجلات للمطابقة. يتم كل الاتصال عبر HTTP/HTTPS مع التحقق من رمز المصادقة وتشفير AES-256 اختياري. استكشف المنصة على CamsBiometrics.com، واقرأ الوثائق الكاملة لـ Callback API على developer.camsbiometrics.com.

Was this article helpful?