تكامل Webhook
تتيح لك webhooks لأنظمتك تلقي إشعارات فورية عند حدوث أحداث في حساب Wink الخاص بك — مثل الحجوزات الجديدة، الإلغاءات، تحديثات المدفوعات، والمزيد. يوجهك هذا الدليل خلال الإعداد وأفضل الممارسات.
الجمهور
Section titled “الجمهور”هذا الدليل موجه للمطورين الذين يدمجون Wink مع أنظمة خارجية مثل أنظمة إدارة العقارات (PMS)، مديري القنوات، أنظمة إدارة علاقات العملاء (CRM)، أو لوحات تحكم مخصصة.
كيف تعمل webhooks
Section titled “كيف تعمل webhooks”- تقوم بتسجيل عنوان URL الخاص بالويب هوك على Wink.
- عند حدوث حدث (مثل حجز جديد)، يرسل Wink طلب HTTP POST إلى عنوان URL الخاص بك.
- يعالج الخادم الخاص بك الحمولة ويرد بـ
200 OK.
إعداد webhook
Section titled “إعداد webhook”- سجّل الدخول إلى حسابك (Extranet أو Studio أو TripPay — جميعها تدعم webhooks).
- انتقل إلى
ApplicationsثمWebhooks. راجع Webhooks. - انقر على
Create webhook. - أدخل اسمًا (مثل “مزامنة حجز PMS”).
- أدخل عنوان URL الخاص بالويب هوك — نقطة النهاية HTTPS على خادمك.
- اختر الأحداث — اختر الأحداث المحددة للاشتراك بها، أو اتركها فارغة لتلقي جميع الأحداث.
- فعّل خيار Enabled.
- انقر على
Save.
أنواع الأحداث
Section titled “أنواع الأحداث”يدعم Wink أكثر من 64 نوعًا من أحداث الويب هوك عبر فئات تشمل إدارة الحساب، عقود الحجز، المدفوعات، تحديثات مدير القناة، وإدارة الكيانات. تشمل الأحداث الشائعة:
| الفئة | أمثلة |
|---|---|
| الحجز | booking.create, booking.cancelled |
| عقد الحجز | booking.contract.created, booking.contract.processing, booking.contract.cancelled |
| المدفوعات | internal.payment.succeeded, internal.payment.failed |
| المبالغ المستردة | booking.contract.refund.partial, booking.contract.refund.full |
| مدير القناة | channel-manager.update.rate, channel-manager.update.availability |
| الحساب | account.create, account.status.updated |
للحصول على قائمة كاملة بكل نوع حدث مع الوصف، راجع كتالوج أحداث Webhook.
عرض جميع أنواع الأحداث الـ 64+
أفضل الممارسات
Section titled “أفضل الممارسات”- استخدم HTTPS — يرسل Wink الحمولات إلى نقاط نهاية HTTPS فقط.
- استجب بسرعة — أعد
200 OKبمجرد استلام الحمولة. قم بأي معالجة ثقيلة بشكل غير متزامن. - التكرار (Idempotency) — يجب أن يكون المعالج الخاص بك متكرراً. قد يعيد Wink محاولة التسليم إذا لم يتلقَ رد
200. - تحقق من المصدر — تحقق من أن الطلبات الواردة من Wink قبل المعالجة.
- التسجيل — سجّل كل حمولة webhook تستلمها. هذا يسهل كثيرًا من عملية تصحيح أخطاء التكامل.
الإيقاف المؤقت والحذف
Section titled “الإيقاف المؤقت والحذف”يمكنك تعطيل webhook دون حذفه. هذا يوقف التسليم مؤقتًا لتتمكن من استكشاف الأخطاء دون فقدان الإعدادات. عندما تكون جاهزًا، قم بتفعيله مرة أخرى.
حذف webhook يزيله نهائيًا. أي تكامل يعتمد على هذا webhook سيتوقف عن تلقي الإشعارات.
قراءة إضافية
Section titled “قراءة إضافية”- كتالوج أحداث Webhook — قائمة كاملة بكل أنواع الأحداث الـ 64+.
- Webhooks — مرجع كامل لإدارة webhooks.
- Applications — إدارة بيانات اعتماد API الخاصة بك.
- Developers > APIs — توثيق API الكامل.