אינטגרציית Webhook

Webhooks מאפשרים למערכות שלך לקבל התראות בזמן אמת כאשר מתרחשים אירועים בחשבון Wink שלך — הזמנות חדשות, ביטולים, עדכוני תשלום ועוד. מדריך זה מלווה אותך בתהליך ההגדרה ובשיטות עבודה מומלצות.

קהל יעד

מדריך זה מיועד למפתחים המשלבים את Wink עם מערכות חיצוניות כגון מערכות ניהול נכסים (PMS), מנהלי ערוצים, CRM או לוחות בקרה מותאמים אישית.

איך Webhooks עובדים

אתה רושם כתובת URL של webhook ב-Wink.
כאשר מתרחש אירוע (למשל, הזמנה חדשה), Wink שולח בקשת HTTP POST לכתובת ה-URL שלך.
השרת שלך מעבד את המידע ומחזיר תגובה 200 OK.

הגדרת webhook

היכנס לחשבונך (Extranet, Studio או TripPay — כולם תומכים ב-webhooks).
עבור אל Applications ואז ל-Webhooks. ראה Webhooks.
לחץ על Create webhook.
הזן שם (למשל, “סנכרון הזמנות PMS”).
הזן את כתובת ה-URL של ה-webhook — נקודת הקצה HTTPS בשרת שלך.
בחר אירועים — בחר אירועים ספציפיים למנוי, או השאר ריק כדי לקבל את כל האירועים.
הפעל את המתג Enabled.
לחץ על Save.

סוגי אירועים

Wink תומך במגוון סוגי אירועים. אירועים נפוצים כוללים:

הזמנה נוצרה — הזמנה חדשה אושרה.
הזמנה בוטלה — הזמנה בוטלה.
תשלום הושלם — התשלום עבר עיבוד.
הזמנה עודכנה — פרטים בהזמנה השתנו.

שיטות עבודה מומלצות

השתמש ב-HTTPS — Wink שולח מידע רק לנקודות קצה HTTPS.
הגב במהירות — החזר 200 OK מיד עם קבלת המידע. עיבוד כבד יש לבצע באופן אסינכרוני.
אידמפוטנטיות — המטפל שלך צריך להיות אידמפוטנטי. Wink עשוי לנסות לשלוח שוב אם לא מתקבלת תגובת 200.
אמת את המקור — ודא שהבקשות הנכנסות הן מ-Wink לפני העיבוד.
רישום — רשום כל payload של webhook שאתה מקבל. זה מקל על איתור תקלות באינטגרציה.

השהייה ומחיקה

אתה יכול לנטרל webhook מבלי למחוק אותו. זה עוצר את השליחה כדי שתוכל לטפל בבעיות מבלי לאבד את ההגדרות. כשתהיה מוכן, הפעל אותו שוב.

מחיקת webhook מסירה אותו לצמיתות. כל אינטגרציה שתלויה ב-webhook זה תפסיק לקבל התראות.

קריאה נוספת

Webhooks — הפניה מלאה לניהול webhooks.
Applications — ניהול אישורי API שלך.
Developers > APIs — תיעוד API מלא.