דלגו לתוכן

התחלה מהירה

מדריך זה לוקח אותך מאפס לאינטגרציה עובדת בכ-30 דקות. בסופו יהיה לך:

  • מחירים חיים למלונות בעיר, מ-Partner API,
  • קישור הזמנה שמייחס הזמנות לחשבונך,
  • הזמנה לבדיקות, ו-webhook שמודיע לך שזה קרה.

הכל קורה בstaging, סביבת הבדיקות שלנו. אין צורך לבקש מאיתנו גישה, ומעבר לייצור מאוחר יותר אינו דורש אישור.

האם זה המדריך המתאים לך?

Section titled “האם זה המדריך המתאים לך?”
אתה רוצה…התחל כאן
להציג מלונות באפליקציה, באתר או במוצר AI ולשלוח מטיילים להזמין, ולהרוויח עמלההמדריך הזה
להזמין בשם הלקוחות שלך כסוכנות נסיעות מורשיתהמדריך עד שלב 5, ואז הזמנה כסוכנות נסיעות
לשלב מלונות להזמנה ללא כתיבת אינטגרציהWeb Components
לאפשר לסוכן AI לחפש ולהזמיןMCP Servers ו-Agentic Payments
לחבר מנהל ערוץ או PMSהוסף את מנהל הערוץ שלך

אתה משתמש ב-Partner API כדי למצוא מלונות ומחיריהם החיים. כל מלון מגיע עם urlName יציב. אתה הופך אותו לקישור למנוע ההזמנות של Wink, book.wink.travel, שנושא את מזהי הלקוח שלך. המטייל מזמין ומשלם שם, וההזמנה מיוחסת לחשבונך.

תזדקק ל:

  • grpcurl, או Postman או Insomnia. ה-Partner API הוא gRPC, לא REST.
  • curl.

staging נפרדת לחלוטין מייצור, עם כניסות וחשבונות משלה.

  1. עבור ל-staging-app.wink.travel, לחץ על Sign-In / Register והרשם.

  2. לחץ על Accounts בסרגל הצד השמאלי, ואז על Create, ובחר I am an Affiliate. ההזמנות שתשלח מיוחסות לחשבון זה. ראה Create Account.

האפליקציה נותנת לקוד שלך את האישורים שלו.

  1. בכרטיס החשבון שלך, לחץ על Actions > Manage account, ואז על לשונית Applications.

  2. לחץ על Create new application, תן לה שם ובחר Machine-to-machine כסוג הלקוח.

  3. תחת scopes, בחר Inventory & rates (קריאה). ה-Partner API בודק את inventory.read.

  4. לחץ על Create application והעתק את Client ID ו-Client secret. הסוד מוצג פעם אחת בלבד ולא ניתן לשחזרו מאוחר יותר.

ראה Applications לסוגי לקוחות ו-scopes נוספים.

Terminal window
curl -X POST https://staging-iam.wink.travel/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=<YOUR_CLIENT_ID>" \
-d "client_secret=<YOUR_CLIENT_SECRET>" \
-d "scope=inventory.read"

שמור את access_token מהתגובה:

Terminal window
export WINK_TOKEN=<access_token>

אסימונים פוקעים. בקוד שלך, אפשר לספריית OAuth2 לקבל ולרענן אותם. ראה Authentication.

אם בקשת האסימון נדחתה, התגובה היא גוף JSON עם קוד error:

errorסטטוס HTTPסיבה נפוצה
invalid_client401מזהה לקוח או סוד שגויים, או שימוש באישורי ייצור על staging-iam
invalid_scope400הבקשה מבקשת scope שהאפליקציה לא רשומה לו
unauthorized_client400האפליקציה אינה מורשית להשתמש ב-grant של client_credentials
invalid_request400פרמטר דרוש חסר, למשל כשהגוף הוא JSON במקום טופס

שלב 4: מצא את מזהה החשבון שלך

Section titled “שלב 4: מצא את מזהה החשבון שלך”

כל קריאה ל-Partner API מציינת את החשבון שאתה פועל בשמו בכותרת managing-entity-id. רשום את החשבונות שהאסימון שלך יכול לפעול בשמם:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-d '{}' \
staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

העתק את accountId של חשבון השותף משלב 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

ל-staging יש מלונות בדיקה עם זמינות בבנגקוק, לכן החיפוש הזה משתמש ב-slug שלה, bangkok-thailand:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-H "managing-entity-id: $WINK_ACCOUNT_ID" \
-d '{
"urlName": "bangkok-thailand",
"userSession": {
"itinerary": {
"startDate": "2026-12-01",
"nights": 2,
"room": { "adults": 2 }
},
"currencyCode": "USD",
"languageCode": "en"
}
}' \
staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCity

השתמש בתאריך צ’ק-אין עתידי; תאריך עבר נדחה. כל תוצאה כוללת:

  • name, starRating ו-heroImageUrl, מספיק להצגת שורת תוצאה,
  • roomTypes, ההצעות החיות, החדר הזול ביותר ראשון,
  • urlName, ה-slug שאתה צריך לקישור ההזמנה.

מחירים הם מספרים שלמים ביחידות קטנות: חלק ב-10 בחזקת currencyExponent מהתגובה (2 ל-USD, כך ש-12500 הוא $125.00).

לא מכיר את ה-slug של עיר? פענח אותו עם wink.partner.v1.Lookup/Search. לתוכן מלא של נכס, השתמש בשירות Content. התיעוד של Partner API מתעד כל קריאה.

שלב 6: בנה את קישור ההזמנה

Section titled “שלב 6: בנה את קישור ההזמנה”
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> הוא urlName של המלון משלב 5.
  • client-id הוא מזהה הלקוח של האפליקציה שלך משלב 2.
  • configuration-id הוא מזהה ההתאמה האישית שלך: Manage account > Customizations. התאמה אישית גם מגדירה את המיתוג, שפת ברירת המחדל ומטבע ברירת המחדל בעמוד ההזמנה.

העבר את פרטי החיפוש של המטייל

Section titled “העבר את פרטי החיפוש של המטייל”

הוסף את התאריכים, האורחים, השפה והמטבע של המטייל לאותו קישור כדי שעמוד המלון ייפתח עם הפרטים מלאים:

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD
פרמטרמשמעותדוגמה
sdתאריך צ’ק-איןsd=2027-03-14
n או edמספר לילות, או תאריך צ’ק-אאוטn=2 או ed=2027-03-16
rcאורחים לחדרrc=a2 (2 מבוגרים)
lשפת תצוגהl=en
cמטבע תצוגהc=USD
pקוד מבצעp=ABC123

פרמטרים אלה גוברים על ברירות המחדל שהוגדרו בהתאמה האישית שלך. מדריך כפתור הזמנה עכשיו מכסה את הפורמט המלא של rc, כולל ילדים וכמה חדרים.

הקישור פותח את עמוד המלון; הוא לא יכול לבחור מראש חדר או מחיר. המטייל בוחר את החדר בעמוד המלון, במחיר החי.

ראה קישור ישיר לקישור לעמוד הבית של מנוע ההזמנות במקום למלון יחיד.

שלב 7: בצע הזמנה לבדיקות

Section titled “שלב 7: בצע הזמנה לבדיקות”

פתח את הקישור שלך, בחר תאריכים וחדר, וסיים תשלום עם כרטיס בדיקה של Stripe, למשל 4242 4242 4242 4242 עם כל תאריך תפוגה עתידי וכל CVC. לא מחויב כרטיס אמיתי ב-staging. שים לב לקוד ההזמנה בעמוד האישור; הוא מתחיל ב-WNK.

שלב 8: קבל התראות על הזמנות

Section titled “שלב 8: קבל התראות על הזמנות”
  1. בפורטל, עבור ל-Applications > Webhooks והוסף נקודת קצה שמקבלת בקשות POST.

  2. הירשם לאירוע booking.create, או השאר את רשימת האירועים ריקה כדי לקבל הכל בזמן הפיתוח.

  3. שלח לעצמך אירוע בדיקה, ואז בצע הזמנה נוספת וצפה שהיא תגיע.

אמת את חתימת כל משלוח לפני שאתה סומך עליו. ראה Webhook Integration ו-קטלוג אירועי Webhook.

אין שלב אישור למפתחים. (חשבונות סוכנויות נסיעות מאושרים תחילה; ראה להלן.) כשהאינטגרציה שלך עובדת ב-staging:

  1. צור חשבון ואפליקציה ב-app.wink.travel, כפי בשלבים 1 ו-2. האישורים אינם מועברים בין הסביבות.

  2. הסר את staging- מכל מארח:

    stagingייצור
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel
  3. חפש שוב את מזהה החשבון (שלב 4) ואת מזהה ההתאמה האישית (שלב 6). הם שונים מ-staging.

שימוש ב-Partner API נמדד במלונות-לילות, עם הקצבה חודשית חינמית. ראה Partner API למחירים ומגבלות.

אם החשבון שלך הוא סוכנות נסיעות מורשית, אין צורך לשלוח מטיילים ל-book.wink.travel: ניתן ליצור הזמנות ישירות עם wink.partner.v1.Booking/CreateBooking, ולנהל אותן עם שאר קריאות Booking. חשבונות אחרים שולחים מטיילים לקישור ההזמנה במקום.

חשבונות סוכנויות נסיעות מאושרים: Wink בודקת את רישום כל סוכנות לפני שהיא יכולה להזמין. סוכנויות שרוצות לגבות תשלום מלקוחותיהן בעצמן, כסוחר רשום, חייבות להזמין דרך Partner API ולקבל אישור בכתב מ-Wink. ראה התחלה כסוכנות נסיעות ואת התיעוד של Partner API.