त्वरित आरंभ
यह मार्गदर्शिका आपको लगभग 30 मिनट में कुछ भी न होने से एक कार्यशील एकीकरण तक ले जाती है। अंत तक आपके पास होगा:
- Partner API से किसी शहर के होटलों के लिए लाइव कीमतें,
- एक बुकिंग लिंक जो बुकिंग को आपके खाते में क्रेडिट करता है,
- एक परीक्षण बुकिंग, और एक वेबहुक जो आपको बताता है कि यह हुआ।
सब कुछ स्टेजिंग में होता है, हमारा परीक्षण वातावरण। आपको हमें एक्सेस के लिए पूछने की जरूरत नहीं है, और बाद में प्रोडक्शन में जाने के लिए भी कोई अनुमोदन आवश्यक नहीं है।
क्या यह आपके लिए सही मार्गदर्शिका है?
Section titled “क्या यह आपके लिए सही मार्गदर्शिका है?”| आप क्या करना चाहते हैं… | यहाँ से शुरू करें |
|---|---|
| अपने ऐप, साइट या AI उत्पाद में होटल दिखाएं और यात्रियों को बुकिंग के लिए भेजें, कमीशन कमाएं | यह मार्गदर्शिका |
| अपने ग्राहकों की ओर से एक लाइसेंस प्राप्त ट्रैवल एजेंसी के रूप में बुक करें | इस मार्गदर्शिका को चरण 5 तक पढ़ें, फिर Booking as a travel agency देखें |
| बिना एकीकरण लिखे बुक करने योग्य होटल एम्बेड करें | Web Components |
| एक AI एजेंट को खोजने और बुक करने दें | MCP Servers और Agentic Payments |
| एक चैनल मैनेजर या PMS कनेक्ट करें | Add Your Channel Manager |
यह कैसे काम करता है
Section titled “यह कैसे काम करता है”आप Partner API का उपयोग होटल और उनकी लाइव कीमतें खोजने के लिए करते हैं। प्रत्येक होटल के साथ एक स्थिर urlName आता है। आप इसे Wink Booking Engine, book.wink.travel के लिए एक लिंक में बदलते हैं, जिसमें आपके आईडी होते हैं। यात्री वहां बुकिंग करता है और भुगतान करता है, और बुकिंग आपके खाते में क्रेडिट हो जाती है।
शुरू करने से पहले
Section titled “शुरू करने से पहले”आपको चाहिए:
grpcurl, या Postman या Insomnia। Partner API gRPC है, REST नहीं।curl।
चरण 1: एक स्टेजिंग खाता बनाएं
Section titled “चरण 1: एक स्टेजिंग खाता बनाएं”स्टेजिंग प्रोडक्शन से पूरी तरह अलग है, इसके अपने लॉगिन और खाते हैं।
-
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 चुनें। -
स्कोप के तहत, Inventory & rates (read) चुनें। Partner API
inventory.readकी जांच करता है। -
Create applicationपर क्लिक करें और Client ID और Client secret कॉपी करें। सीक्रेट केवल एक बार दिखाया जाता है और बाद में पुनः प्राप्त नहीं किया जा सकता।
अन्य क्लाइंट प्रकारों और स्कोप के लिए देखें Applications।
चरण 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 | गलत क्लाइंट ID या सीक्रेट, या प्रोडक्शन क्रेडेंशियल staging-iam पर उपयोग किए गए |
invalid_scope | 400 | अनुरोध में ऐसा स्कोप मांगा गया जो एप्लिकेशन के लिए पंजीकृत नहीं है |
unauthorized_client | 400 | एप्लिकेशन को client_credentials ग्रांट का उपयोग करने की अनुमति नहीं है |
invalid_request | 400 | आवश्यक पैरामीटर गायब है, उदाहरण के लिए जब बॉडी JSON है न कि फॉर्म |
चरण 4: अपना खाता ID खोजें
Section titled “चरण 4: अपना खाता ID खोजें”हर Partner API कॉल में उस खाते का नाम होता है जिसके लिए आप कार्य कर रहे हैं, managing-entity-id हेडर में। उन खातों की सूची बनाएं जिनके लिए आपका टोकन कार्य कर सकता है:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsचरण 1 के सहायक खाते का accountId कॉपी करें:
export WINK_ACCOUNT_ID=<accountId>चरण 5: किसी शहर में होटल खोजें
Section titled “चरण 5: किसी शहर में होटल खोजें”स्टेजिंग में बैंकॉक में उपलब्धता वाले परीक्षण होटल हैं, इसलिए यह खोज इसका स्लग, 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, वह स्लग जो आपको बुकिंग लिंक के लिए चाहिए।
कीमतें छोटे इकाइयों में पूर्णांक होती हैं: प्रतिक्रिया से currencyExponent की शक्ति के 10 से विभाजित करें (USD के लिए 2, इसलिए 12500 $125.00 है)।
शहर का स्लग नहीं पता? इसे 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>चरण 5 से होटल काurlNameहै।client-idआपके एप्लिकेशन का क्लाइंट ID है, चरण 2 से।configuration-idआपकी कस्टमाइजेशन 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 |
ये पैरामीटर आपकी कस्टमाइजेशन में सेट डिफ़ॉल्ट को ओवरराइड करते हैं। Book Now button guide में पूर्ण rc प्रारूप शामिल है, जिसमें बच्चे और कई कमरे शामिल हैं।
लिंक होटल पृष्ठ खोलता है; यह कमरे या दर को पहले से चयनित नहीं कर सकता। यात्री होटल पृष्ठ पर कमरा चुनता है, लाइव कीमत पर।
एकल होटल के बजाय बुकिंग इंजन होम पेज से लिंक करने के लिए देखें Linking directly।
चरण 7: एक परीक्षण बुकिंग करें
Section titled “चरण 7: एक परीक्षण बुकिंग करें”अपना लिंक खोलें, तिथियाँ और कमरा चुनें, और Stripe टेस्ट कार्ड के साथ चेक आउट करें, उदाहरण के लिए 4242 4242 4242 4242 किसी भी भविष्य की समाप्ति तिथि और किसी भी CVC के साथ। स्टेजिंग में कोई वास्तविक कार्ड चार्ज नहीं होता। पुष्टि पृष्ठ पर बुकिंग कोड नोट करें; यह WNK से शुरू होता है।
चरण 8: बुकिंग के बारे में सूचित हों
Section titled “चरण 8: बुकिंग के बारे में सूचित हों”-
पोर्टल में,
Applications > Webhooksपर जाएं और एक ऐसा एंडपॉइंट जोड़ें जोPOSTअनुरोध स्वीकार करता हो। -
booking.createको सब्सक्राइब करें, या विकास के दौरान सब कुछ प्राप्त करने के लिए इवेंट सूची खाली छोड़ दें। -
खुद को एक परीक्षण इवेंट भेजें, फिर एक और परीक्षण बुकिंग करें और इसे आते देखें।
हर डिलीवरी के सिग्नेचर को सत्यापित करें इससे पहले कि आप उस पर भरोसा करें। देखें Webhook Integration और Webhook Events Catalog।
चरण 9: प्रोडक्शन पर जाएं
Section titled “चरण 9: प्रोडक्शन पर जाएं”डेवलपर्स के लिए कोई अनुमोदन चरण नहीं है। (ट्रैवल एजेंसी खाते पहले प्रमाणित होते हैं; नीचे देखें booking-as-a-travel-agency।) जब आपका एकीकरण स्टेजिंग में काम करता है:
-
app.wink.travel पर एक खाता और एप्लिकेशन बनाएं, चरण 1 और 2 के अनुसार। क्रेडेंशियल वातावरणों के बीच स्थानांतरित नहीं होते।
-
हर होस्ट से
staging-हटा दें:स्टेजिंग प्रोडक्शन https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
अपना प्रोडक्शन खाता ID (चरण 4) और कस्टमाइजेशन ID (चरण 6) फिर से देखें। वे स्टेजिंग से अलग होंगे।
Partner API उपयोग होटल-रातों में मापा जाता है, जिसमें एक मुफ्त मासिक आवंटन होता है। मूल्य निर्धारण और सीमाओं के लिए देखें Partner API।
ट्रैवल एजेंसी के रूप में बुकिंग
Section titled “ट्रैवल एजेंसी के रूप में बुकिंग”यदि आपका खाता एक लाइसेंस प्राप्त ट्रैवल एजेंसी है, तो आपको यात्रियों को book.wink.travel पर भेजने की आवश्यकता नहीं है: आप सीधे wink.partner.v1.Booking/CreateBooking के साथ बुकिंग बना सकते हैं, और अन्य Booking कॉल के साथ उनका प्रबंधन कर सकते हैं। अन्य खाते यात्रियों को बुकिंग लिंक पर भेजते हैं।
ट्रैवल एजेंसी खाते प्रमाणित होते हैं: Wink हर एजेंसी के पंजीकरण की समीक्षा करता है इससे पहले कि वह बुक कर सके। जो एजेंसियां अपने ग्राहकों से स्वयं भुगतान एकत्र करना चाहती हैं, मर्चेंट ऑफ रिकॉर्ड के रूप में, उन्हें Partner API के माध्यम से बुक करना होगा और Wink की लिखित मंजूरी प्राप्त करनी होगी। देखें Getting Started as a Travel Agency और Partner API reference।
अगले कदम
Section titled “अगले कदम”.protoस्कीमा से टाइप्ड क्लाइंट जनरेट करें बजाय मैन्युअल रूप सेgrpcurlकॉल करने के।- MCP सर्वर कनेक्ट करें और AI Skills का उपयोग करें ताकि आपका कोडिंग सहायक लाइव API के खिलाफ एकीकरण लिख सके।
- पर्यावरण और होस्ट की पूरी सूची पढ़ें।
