الملخص
تتيح الويب هوكس (Web Hooks) لـ KnowledgeCity إشعار الأنظمة الخارجية تلقائيًا عند حدوث أحداث تكامل. تقوم بتسجيل عنوان URL لنقطة نهاية، وتختار الأحداث التي يجب أن تستقبلها، وترسل KnowledgeCity طلبًا موقَّعًا إلى ذلك العنوان في كل مرة يحدث فيها حدث مطابق. يتيح هذا للتطبيقات اللاحقة الاستجابة في وقت قريب من الفعلي بدلًا من الاستقصاء المتكرر عن التغييرات.
مقدمة
تُشغِّل معظم المؤسسات KnowledgeCity إلى جانب أنظمة أخرى، وغالبًا ما تحتاج تلك الأنظمة إلى معرفة وقت حدوث أي تغيير. توفر الويب هوكس قناة إشعارات صادرة: فبدلًا من أن تطلب أداة خارجية تحديثات من KnowledgeCity وفق جدول زمني، تدفع KnowledgeCity الحدث إلى تلك الأداة في اللحظة التي يحدث فيها.
يتم تهيئة الويب هوكس من قبل المسؤولين وأصحاب التكاملات — وهم الأشخاص المسؤولون عن ربط KnowledgeCity ببقية حزمة التقنيات. وهي تحل مشكلة الحفاظ على تزامن الأنظمة الخارجية مع الأحداث عند وقوعها، بشكل موثوق وآمن، دون إدخال يدوي للبيانات أو استقصاء مستمر.
المفاهيم الأساسية
- الويب هوك (Web Hook) — إشعار صادر ترسله KnowledgeCity إلى عنوان URL خارجي عند حدوث حدث محدد، حتى يتمكن نظام آخر من الاستجابة للتغيير تلقائيًا.
- عنوان URL لنقطة النهاية — العنوان الخارجي الذي تتحكم فيه وتستقبل عليه طلبات الإشعار. يجب أن يكون قادرًا على قبول الطلبات الواردة والتحقق منها.
- الأحداث (Events) — حالات تكامل محددة تشترك فيها نقطة نهاية؛ ترسل KnowledgeCity طلبًا فقط عند حدوث حدث مطابق.
- توقيع HMAC — كل طلب صادر موقَّع بواسطة HMAC حتى يتمكن النظام المستقبل من التحقق من أن الرسالة صادرة فعليًا من KnowledgeCity ولم يتم التلاعب بها.
- إعادة المحاولة مع التأخير التصاعدي — إذا لم تنجح عملية تسليم، تُعيد KnowledgeCity المحاولة باستخدام تأخير تصاعدي (exponential back-off)، مما يجعل التسليم موثوقًا حتى عندما تكون نقطة النهاية غير متاحة مؤقتًا.
- سجل التدقيق (Audit Log) — سجل يحتفظ بكل محاولة تسليم، حتى تتمكن من مراجعة ما تم إرساله وتأكيد الاستلام أو تشخيص الأعطال.
الخطوات التي يجب اتباعها
فتح إعدادات الويب هوكس
سجّل الدخول بصفتك مسؤولًا وافتح منطقة التكاملات من إعدادات حسابك. من هنا يمكنك إدارة الويب هوكس الصادرة لحسابك إلى جانب نقاط الاتصال الأخرى.
تسجيل عنوان URL لنقطة النهاية
في قسم الويب هوكس، سجّل عنوان URL لنقطة النهاية الخارجية التي يجب أن تستقبل إشعارات الأحداث. استخدم نقطة نهاية تتحكم فيها ومُهيَّأة لقبول الطلبات الواردة عبر HTTPS. ولأن الإشعارات تُدفع إلى هذا العنوان عند وقوع الأحداث، ينبغي أن تكون نقطة النهاية قابلة للوصول وقادرة على الاستجابة بسرعة.
اختيار الأحداث المطلوب استقبالها
اختر الأحداث التي يجب إشعار نقطة النهاية بها. ترسل KnowledgeCity طلبًا إلى نقطة نهايتك فقط عند حدوث أحد الأحداث المحددة، لذا فإن الاشتراك في الأحداث التي يهتم بها نظامك الخارجي فقط يجعل حركة البيانات مركّزة وذات صلة.
التحقق من عمليات التسليم الموقَّعة
كل طلب صادر موقَّع بواسطة HMAC. على الجانب المستقبل، تحقق من هذا التوقيع قبل التصرف بناءً على إشعار للتأكد من أن الطلب صادر فعليًا من KnowledgeCity ولم يُعدَّل خلال النقل. رفض الطلبات التي تفشل في التحقق من التوقيع يحمي نقطة نهايتك من الرسائل المزيفة أو المتلاعب بها.
الاعتماد على إعادة المحاولات ومراجعة سجل التدقيق
التسليم مصمَّم ليكون موثوقًا. إذا كانت نقطة نهايتك غير قابلة للوصول مؤقتًا، تُعيد KnowledgeCity المحاولة باستخدام تأخير تصاعدي بدلًا من إسقاط الإشعار. للتأكد من ما تم إرساله وموعده، راجع سجل التدقيق، الذي يحتفظ بكل محاولة تسليم حتى تتمكن من تأكيد الاستلام الناجح أو التحقيق في أي أعطال.
الخاتمة
توفر الويب هوكس للمسؤولين طريقة موثوقة لدفع أحداث التكامل إلى الأنظمة التي تعتمد عليها. من خلال تسجيل عنوان URL موثوق لنقطة النهاية، وإشراكها في الأحداث الصحيحة، والتحقق من توقيع HMAC في كل طلب، والاعتماد على إعادة المحاولات التلقائية وسجل التدقيق، يمكنك الحفاظ على تزامن الأنظمة الخارجية في وقت قريب من الفعلي مع الحفاظ على أمان التسليم وإمكانية التحقق منه.