התחלה מהירה
מדריך זה לוקח אותך מאפס לאינטגרציה עובדת בכ-30 דקות. בסופו יהיה לך:
- מחירים חיים למלונות בעיר, מ-Partner API,
- קישור הזמנה שמייחס הזמנות לחשבונך,
- הזמנה לבדיקות, ו-webhook שמודיע לך שזה קרה.
הכל קורה בstaging, סביבת הבדיקות שלנו. אין צורך לבקש מאיתנו גישה, ומעבר לייצור מאוחר יותר אינו דורש אישור.
האם זה המדריך המתאים לך?
Section titled “האם זה המדריך המתאים לך?”| אתה רוצה… | התחל כאן |
|---|---|
| להציג מלונות באפליקציה, באתר או במוצר AI ולשלוח מטיילים להזמין, ולהרוויח עמלה | המדריך הזה |
| להזמין בשם הלקוחות שלך כסוכנות נסיעות מורשית | המדריך עד שלב 5, ואז הזמנה כסוכנות נסיעות |
| לשלב מלונות להזמנה ללא כתיבת אינטגרציה | Web Components |
| לאפשר לסוכן AI לחפש ולהזמין | MCP Servers ו-Agentic Payments |
| לחבר מנהל ערוץ או PMS | הוסף את מנהל הערוץ שלך |
איך זה עובד
Section titled “איך זה עובד”אתה משתמש ב-Partner API כדי למצוא מלונות ומחיריהם החיים. כל מלון מגיע עם urlName יציב. אתה הופך אותו לקישור למנוע ההזמנות של Wink, book.wink.travel, שנושא את מזהי הלקוח שלך. המטייל מזמין ומשלם שם, וההזמנה מיוחסת לחשבונך.
לפני שמתחילים
Section titled “לפני שמתחילים”תזדקק ל:
grpcurl, או Postman או Insomnia. ה-Partner API הוא gRPC, לא REST.curl.
שלב 1: צור חשבון ב-staging
Section titled “שלב 1: צור חשבון ב-staging”staging נפרדת לחלוטין מייצור, עם כניסות וחשבונות משלה.
-
עבור ל-staging-app.wink.travel, לחץ על
Sign-In / Registerוהרשם. -
לחץ על
Accountsבסרגל הצד השמאלי, ואז עלCreate, ובחר I am an Affiliate. ההזמנות שתשלח מיוחסות לחשבון זה. ראה Create Account.
שלב 2: צור אפליקציה
Section titled “שלב 2: צור אפליקציה”האפליקציה נותנת לקוד שלך את האישורים שלו.
-
בכרטיס החשבון שלך, לחץ על
Actions>Manage account, ואז על לשוניתApplications. -
לחץ על
Create new application, תן לה שם ובחר Machine-to-machine כסוג הלקוח. -
תחת scopes, בחר Inventory & rates (קריאה). ה-Partner API בודק את
inventory.read. -
לחץ על
Create applicationוהעתק את Client ID ו-Client secret. הסוד מוצג פעם אחת בלבד ולא ניתן לשחזרו מאוחר יותר.
ראה Applications לסוגי לקוחות ו-scopes נוספים.
שלב 3: קבל אסימון גישה
Section titled “שלב 3: קבל אסימון גישה”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 מהתגובה:
export WINK_TOKEN=<access_token>אסימונים פוקעים. בקוד שלך, אפשר לספריית OAuth2 לקבל ולרענן אותם. ראה Authentication.
אם בקשת האסימון נדחתה, התגובה היא גוף JSON עם קוד error:
error | סטטוס HTTP | סיבה נפוצה |
|---|---|---|
invalid_client | 401 | מזהה לקוח או סוד שגויים, או שימוש באישורי ייצור על staging-iam |
invalid_scope | 400 | הבקשה מבקשת scope שהאפליקציה לא רשומה לו |
unauthorized_client | 400 | האפליקציה אינה מורשית להשתמש ב-grant של client_credentials |
invalid_request | 400 | פרמטר דרוש חסר, למשל כשהגוף הוא JSON במקום טופס |
שלב 4: מצא את מזהה החשבון שלך
Section titled “שלב 4: מצא את מזהה החשבון שלך”כל קריאה ל-Partner API מציינת את החשבון שאתה פועל בשמו בכותרת managing-entity-id. רשום את החשבונות שהאסימון שלך יכול לפעול בשמם:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsהעתק את accountId של חשבון השותף משלב 1:
export WINK_ACCOUNT_ID=<accountId>שלב 5: חפש מלונות בעיר
Section titled “שלב 5: חפש מלונות בעיר”ל-staging יש מלונות בדיקה עם זמינות בבנגקוק, לכן החיפוש הזה משתמש ב-slug שלה, bangkok-thailand:
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: קבל התראות על הזמנות”-
בפורטל, עבור ל-
Applications > Webhooksוהוסף נקודת קצה שמקבלת בקשותPOST. -
הירשם לאירוע
booking.create, או השאר את רשימת האירועים ריקה כדי לקבל הכל בזמן הפיתוח. -
שלח לעצמך אירוע בדיקה, ואז בצע הזמנה נוספת וצפה שהיא תגיע.
אמת את חתימת כל משלוח לפני שאתה סומך עליו. ראה Webhook Integration ו-קטלוג אירועי Webhook.
שלב 9: עבור לייצור
Section titled “שלב 9: עבור לייצור”אין שלב אישור למפתחים. (חשבונות סוכנויות נסיעות מאושרים תחילה; ראה להלן.) כשהאינטגרציה שלך עובדת ב-staging:
-
צור חשבון ואפליקציה ב-app.wink.travel, כפי בשלבים 1 ו-2. האישורים אינם מועברים בין הסביבות.
-
הסר את
staging-מכל מארח:staging ייצור https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
חפש שוב את מזהה החשבון (שלב 4) ואת מזהה ההתאמה האישית (שלב 6). הם שונים מ-staging.
שימוש ב-Partner API נמדד במלונות-לילות, עם הקצבה חודשית חינמית. ראה Partner API למחירים ומגבלות.
הזמנה כסוכנות נסיעות
Section titled “הזמנה כסוכנות נסיעות”אם החשבון שלך הוא סוכנות נסיעות מורשית, אין צורך לשלוח מטיילים ל-book.wink.travel: ניתן ליצור הזמנות ישירות עם wink.partner.v1.Booking/CreateBooking, ולנהל אותן עם שאר קריאות Booking. חשבונות אחרים שולחים מטיילים לקישור ההזמנה במקום.
חשבונות סוכנויות נסיעות מאושרים: Wink בודקת את רישום כל סוכנות לפני שהיא יכולה להזמין. סוכנויות שרוצות לגבות תשלום מלקוחותיהן בעצמן, כסוחר רשום, חייבות להזמין דרך Partner API ולקבל אישור בכתב מ-Wink. ראה התחלה כסוכנות נסיעות ואת התיעוד של Partner API.
השלבים הבאים
Section titled “השלבים הבאים”- צור לקוח טיפוסי מתוך סכמת
.protoבמקום לקרוא ל-grpcurlידנית. - חבר את שרת MCP והשתמש ב-AI Skills כדי שסייע הקידוד שלך יכתוב את האינטגרציה מול ה-API החי.
- קרא את הרשימה המלאה של סביבות ומארחים.
