Setup
यह लेख आपको बताता है कि कैसे एक डेवलपर के रूप में जल्दी से सेटअप किया जाए और विंक पर हमारे एपीआई का परीक्षण शुरू किया जाए।
:::नोट परीक्षण हमेशा हमारे यहां होना चाहिएमंचन वातावरणइसमें बहुत कम डेटा है लेकिन आप उत्पादन वातावरण पर दबाव डाले बिना जितना चाहें उतना परीक्षण करने के लिए स्वतंत्र हैं।
एक बार जब आप लाइव होने के लिए तैयार हो जाते हैं, तो हम आपके खाते और आपके आवेदन को प्रमाणित करेंगे और आप हमारे उत्पादन वातावरण में लॉन्च कर सकते हैं।
इन चरणों का पालन करें:
- पंजीकरण करवाना विंक पर आपका उपयोगकर्ता खाता
- एक बनाने के ट्रैवल एजेंट खाता या एक सहबद्ध खाता.
- एक एप्लिकेशन बनाएं जहां आप इसे चरण 2 में बनाए गए खाते से संबद्ध करते हैं।
- एक बार जब आप अपना बना लेते हैं
Application
, क्लाइंट-आईडी और क्लाइंट सीक्रेट को सुरक्षित स्थान पर सहेजें।
सीडीएन
Section titled “सीडीएन”विंक में, हम अपनी सभी छवि और वीडियो संपत्तियों के लिए क्लाउडिनरी का उपयोग करते हैं। जब आप हमारी यात्रा सूची तक पहुँचते हैं, तो आपको क्लाउडिनरी की सभी उन्नत सुविधाओं तक पूरी पहुँच प्राप्त होगी।
हमारा cloud_name
है traveliko
.
क्लाउडिनरी
Section titled “क्लाउडिनरी”उदाहरण
Section titled “उदाहरण”हमारे द्वारा समर्थित प्रत्येक यात्रा सूची प्रकार के लिए, एक नेस्टेड JSON सरणी होगी जिसे कहा जाता हैmultimedias
मल्टीमीडिया प्रविष्टि के लिए JSON इस तरह दिखता है:
{ "multimediaIdentifier": "multimedia-1", "identifier": "partners/radisson_blu_logo", "type": "IMAGE", "width": "1024", "height": "768", "category": "1", "descriptions": [ { "name": "Lobby", "description": "Picture of the lobby", "language": "en" } ], "lifestyleType": "LIFESTYLE_BUSINESS", "attribution": [ { "url": "https://www.hilton.com", "name": "Hilton" } ]}
ऊपर हाइलाइट की गई लाइन क्लाउडिनरी की विशिष्ट आईडी दिखाती हैpartners/radisson_blu_logo
. आपको अपनी इच्छानुसार किसी भी प्रारूप, गुणवत्ता और आकार में छवि प्राप्त करने के लिए बस इतना ही करना होगा।
परीक्षण
Section titled “परीक्षण”हमारे पेज पर जाएँशहद की मक्खीअनुभाग पर जाएं और वह API चुनें जिसके साथ आप काम करना चाहते हैं.
एपीआई दस्तावेज़
Section titled “एपीआई दस्तावेज़”हमारी दस्तावेज़ीकरण साइट इस तरह से स्थापित की गई है कि आप साइट के भीतर से API कमांड चला सकते हैं।
इस उदाहरण में, आप उपयोग करना चाहते हैंSearch Lookups (OAuth2)
एपीआई कॉल.
:::टिप[प्रो टिप]
उपयोग में आसानी के लिए, हम अनुशंसा करते हैं कि इंटीग्रेटर हमारे द्वारा निर्दिष्ट एंडपॉइंट का उपयोग करेंOAuth2
वे एंडपॉइंट एपीआई कॉलर्स की अपेक्षा करते हैं और पहले से ही जानते हैं कि आप किस खाते पर हैं, इसलिए आपको निर्दिष्ट करने की आवश्यकता नहीं हैcompanyIdentifier
अपने यूआरएल में.
:::
- उपयोग लुकअप एपीआई गंतव्य या होटल पुनः प्राप्त करने के लिए.
- बाएं नेविगेशन बार में, पर क्लिक करें
Authentication
. - अपना क्लाइंट-आईडी और क्लाइंट सीक्रेट दर्ज करें और क्लिक करें
Get TOKEN
बटन। - यदि आपके क्रेडेंशियल वैध हैं, तो आप देखेंगे कि आपकी API कुंजी लागू कर दी गई है।
- अब आप लुकअप एंडपॉइंट का परीक्षण कर सकते हैं.
डाकिया
Section titled “डाकिया”आप पोस्टमैन के साथ भी यही काम कर सकते हैं।
- डाउनलोड करना डाकिया.
- पर क्लिक करें
Download OpenAPI spec
के ऊपर से लुकअप एपीआई पृष्ठ. - इसे पोस्टमैन में आयात करें.
- यदि आपने इसे एक नए संग्रह के रूप में आयात किया है
Wink API
, संग्रह नाम के आगे क्षैतिज एलिप्सिस (3 बिंदु) पर क्लिक करें और क्लिक करेंEdit
. - में
Authorization tab
, सेट करेंAuth type
OAuth2 के लिए. - फ़ील्ड सेट करें
Add auth data to
कोRequest headers
. - फ़ील्ड सेट करें
Header prefix
कोBearer
. - फ़ील्ड सेट करें
Token Name
आप पोस्टमैन में अपने सहेजे गए टोकन को जो भी नाम देना चाहें, उसे चुनें। जैसे: विंक स्टेजिंग। - फ़ील्ड सेट करें
Grant type
कोClient Credentials
. - फ़ील्ड सेट करें
Access token URL
https://staging-iam.wink.travel/oauth2/token पर जाएं. - फ़ील्ड सेट करें
Client ID
आपके ऐप द्वारा जेनरेट की गई क्लाइंट आईडी पर. - फ़ील्ड सेट करें
Client Secret
आपके ऐप द्वारा जेनरेट किए गए क्लाइंट सीक्रेट को. - फ़ील्ड सेट करें
Scope
कोinventory.read inventory.write inventory.remove
ये सभी स्कोप हैं जिनकी आपको विंक के लिए आवश्यकता होगी। - फ़ील्ड सेट करें
Client Authentication
कोSend as Basic Auth header
. - क्लिक करें
Get New Access Token
अपना टोकन पुनः प्राप्त करने और उसे सहेजने के लिए बटन दबाएं। - विंक API संग्रह के अंतर्गत सभी API कॉल के लिए, सुनिश्चित करें कि प्रमाणीकरण टैब कहता है
Inherit auth from parent
इसलिए इसमें हर कॉल के साथ आपका टोकन शामिल होता है।
:::टिप[प्रो टिप] सर्वर डोमेन, क्लाइंट आईडी और क्लाइंट सीक्रेट को एनवायरनमेंट वैरिएबल में बदलने की सलाह दी जाती है। इस तरह आप स्टेजिंग और प्रोडक्शन एनवायरनमेंट के बीच आसानी से स्विच कर सकते हैं और अपने द्वारा बनाए गए सभी ऑपरेशन का फिर से उपयोग कर सकते हैं। :::