كيفية إعداد خطافات الويب

ترسل خطافات الويب أحداث TicketingHub المحددة إلى نظام آخر فور حدوثها.

قبل البدء

• يجب تفعيل خطافات الويب لحسابك في TicketingHub. تواصل مع TicketingHub إذا كان قسم خطافات الويب غير ظاهر.
• يجب أن تمتلك صلاحيات مسؤول أو مدير.
• يجب أن يوفّر النظام المستلم عنوان URL عامًا يستخدم HTTPS.

إضافة خطاف ويب

1. انتقل إلى الإعدادات → الإعدادات المتقدمة.
2. ابحث عن خطافات الويب واختر تحرير.
3. اختر خطاف ويب جديد.
4. أدخل عنوان URL الذي يستخدم HTTPS والذي سيستقبل الأحداث.
5. اختر أنواع الأحداث التي تريد إرسالها، مثل تأكيد حجز أو إلغائه.
6. اختياري: أدخل مفتاحًا سريًا قويًا حتى يتمكن النظام المستلم من التحقق من كل طلب.
7. أنشئ خطاف الويب، ثم نفّذ أحد الأحداث المحددة لاختباره.

إذا أضفت مفتاحًا سريًا، توقّع TicketingHub كل طلب وترسل التوقيع في الترويسة X-TicketingHub-Signature-256. يجب على المطوّر التحقق من هذا التوقيع قبل قبول البيانات.

الحفاظ على نشاط خطاف الويب

ينبغي أن يرد النظام المستلم بسرعة بحالة ناجحة من فئة 2xx. تعيد TicketingHub محاولة إرسال البيانات التي تنتهي مهلتها أو تُرجع استجابة غير ناجحة. ويُعطَّل تلقائيًا أي طرف نهائي يستمر في الفشل؛ أصلح النظام المستلم، ثم عُد إلى صفحة خطافات الويب وفعّله مرة أخرى.

ترسل TicketingHub الأحداث إلى العناوين العامة فقط. إذا كان عنوان URL يشير إلى عنوان شبكة خاصة، مثل خادم داخل شبكتك الخاصة، فلن ترسل TicketingHub الحدث وستعطّل خطاف الويب فورًا. تعرض صفحة خطافات الويب الرسالة “يشير عنوان URL إلى عنوان شبكة خاصة”، ويتلقى مسؤولو حسابك رسالة بريد إلكتروني. غيّر عنوان URL إلى عنوان عام باستخدام HTTPS، ثم فعّل خطاف الويب مرة أخرى.

اختر الأحداث التي تحتاج إليها فقط، وتجنّب استخدام عنوان URL للاختبار في حساب فعلي. لإرسال الأحداث إلى Zapier من دون إنشاء نظام استقبال خاص بك، راجع كيفية ربط TicketingHub بـ Zapier. ولإنشاء تكامل يطلب البيانات من TicketingHub أيضًا، راجع كيفية إنشاء رمز API واستخدامه.