אינטגרציית Webhook
Webhooks מאפשרים למערכות שלך לקבל התראות בזמן אמת כאשר אירועים מתרחשים בחשבון Wink שלך — הזמנות חדשות, ביטולים, עדכוני תשלום ועוד. מדריך זה מלווה אותך בהגדרה ובשיטות עבודה מומלצות.
קהל יעד
Section titled “קהל יעד”מדריך זה מיועד למפתחים המשלבים את Wink עם מערכות חיצוניות כגון מערכות ניהול נכסים (PMS), מנהלי ערוצים, CRM או לוחות בקרה מותאמים אישית.
איך Webhooks עובדים
Section titled “איך Webhooks עובדים”- אתה רושם כתובת URL של webhook ב-Wink.
- כאשר מתרחש אירוע (למשל, הזמנה חדשה), Wink שולח בקשת HTTP POST לכתובת ה-URL שלך.
- השרת שלך מעבד את המידע ומחזיר תגובה
200 OK.
הגדרת webhook
Section titled “הגדרת webhook”- היכנס לחשבונך (Extranet, Studio או TripPay — כולם תומכים ב-webhooks).
- עבור אל
Applicationsואז ל-Webhooks. ראה Webhooks. - לחץ על
Create webhook. - הזן שם (למשל, “סנכרון הזמנות PMS”).
- הזן את כתובת ה-URL של ה-webhook — נקודת הקצה HTTPS בשרת שלך.
- בחר אירועים — בחר אירועים ספציפיים למנוי, או השאר ריק כדי לקבל את כל האירועים.
- הפעל את המתג Enabled.
- לחץ על
Save.
סוגי אירועים
Section titled “סוגי אירועים”Wink תומך ב-64+ סוגי אירועים של webhook בקטגוריות שונות כולל ניהול חשבון, חוזי הזמנה, תשלומים, עדכוני מנהל ערוצים וניהול ישויות. אירועים נפוצים כוללים:
| קטגוריה | דוגמאות |
|---|---|
| הזמנה | 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מיד עם קבלת המידע. עשה עיבוד כבד באופן אסינכרוני. - אידמפוטנטיות — המטפל שלך צריך להיות אידמפוטנטי. Wink עשוי לנסות לשלוח שוב אם לא מקבל תגובת
200. - אמת את המקור — ודא שהבקשות הנכנסות הן מ-Wink לפני העיבוד.
- רישום — רשום כל payload של webhook שאתה מקבל. זה מקל על איתור תקלות באינטגרציה.
השהייה ומחיקה
Section titled “השהייה ומחיקה”אתה יכול לכבות webhook מבלי למחוק אותו. זה עוצר את השליחה כדי שתוכל לפתור בעיות מבלי לאבד את ההגדרות. כשתהיה מוכן, הפעל אותו שוב.
מחיקת webhook מסירה אותו לצמיתות. כל אינטגרציה שתלויה ב-webhook זה תפסיק לקבל התראות.
קריאה נוספת
Section titled “קריאה נוספת”- קטלוג אירועי Webhook — רשימה מלאה של כל 64+ סוגי האירועים.
- Webhooks — הפניה מלאה לניהול webhooks.
- Applications — ניהול אישורי API שלך.
- Developers > APIs — תיעוד API מלא.