تكامل 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) — يجب أن يكون المعالج الخاص بك idempotent. قد يعيد Wink محاولة الإرسال إذا لم يتلقَ رد
200. - تحقق من المصدر — تحقق من أن الطلبات الواردة من Wink قبل المعالجة.
- التسجيل — سجّل كل حمولة webhook تستلمها. هذا يسهل كثيرًا من عملية تصحيح أخطاء التكامل.
الإيقاف المؤقت والحذف
Section titled “الإيقاف المؤقت والحذف”يمكنك تعطيل webhook دون حذفه. هذا يوقف التسليم حتى تتمكن من استكشاف الأخطاء دون فقدان الإعدادات. عندما تكون جاهزًا، قم بتفعيله مرة أخرى.
حذف webhook يزيله نهائيًا. أي تكامل يعتمد على هذا webhook سيتوقف عن تلقي الإشعارات.
قراءة إضافية
Section titled “قراءة إضافية”- كتالوج أحداث Webhook — قائمة كاملة بكل أنواع الأحداث الـ 64+.
- Webhooks — مرجع كامل لإدارة webhooks.
- Applications — إدارة بيانات اعتماد API الخاصة بك.
- Developers > APIs — توثيق API الكامل.