सेटअप

यह लेख आपको बताता है कि एक डेवलपर के रूप में जल्दी से कैसे सेटअप करें और Wink पर हमारे APIs का परीक्षण कैसे शुरू करें।

परीक्षण हमेशा हमारे स्टेजिंग वातावरण में होना चाहिए। वहाँ डेटा बहुत कम होता है लेकिन आप बिना प्रोडक्शन वातावरण पर प्रभाव डाले जितना चाहें परीक्षण कर सकते हैं।

जब आप लाइव जाने के लिए तैयार हों, तो हम आपके खाते और आपके एप्लिकेशन को प्रमाणित करेंगे और आप हमारे प्रोडक्शन वातावरण में लॉन्च कर सकते हैं।

इन चरणों का पालन करें:

Wink पर अपना उपयोगकर्ता खाता रजिस्टर करें
एक ट्रैवल एजेंट खाता या एक एफिलिएट खाता बनाएं।
एक एप्लिकेशन बनाएं जहाँ आप इसे चरण 2 में बनाए गए खाते से जोड़ते हैं।
एक बार जब आपने अपना Application बना लिया, तो client-id और client secret को सुरक्षित स्थान पर सहेज लें।

CDN

Wink में, हम अपनी सभी छवि और वीडियो संपत्तियों के लिए Cloudinary का उपयोग करते हैं। जब आप हमारे ट्रैवल इन्वेंट्री तक पहुँचते हैं, तो आपको Cloudinary की सभी उन्नत सुविधाओं तक पूर्ण पहुंच प्राप्त होगी।

हमारा cloud_name है traveliko।

Cloudinary

उदाहरण

हम जिन प्रत्येक ट्रैवल इन्वेंट्री प्रकार का समर्थन करते हैं, उनके लिए एक नेस्टेड 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"
    }
  ]
}

ऊपर हाइलाइट की गई पंक्ति Cloudinary का यूनिक ID partners/radisson_blu_logo दिखाती है। यही वह सब है जिसकी आपको किसी भी फॉर्मेट, गुणवत्ता और आकार में छवि प्राप्त करने के लिए आवश्यकता है।

परीक्षण

हमारे APIs सेक्शन पर जाएं और उस API को चुनें जिसके साथ आप काम करना चाहते हैं।

API दस्तावेज़

हमारी दस्तावेज़ साइट इस तरह से सेटअप है कि आप साइट के भीतर से API कमांड चला सकते हैं।

इस उदाहरण में, आप Search Lookups (OAuth2) API कॉल का उपयोग करना चाहते हैं।

गंतव्य या होटलों को प्राप्त करने के लिए Lookup API का उपयोग करें।
बाएं नेवबार में, Authentication पर क्लिक करें।
अपना client-id और client secret दर्ज करें और Get TOKEN बटन पर क्लिक करें।
यदि आपकी प्रमाण-पत्र मान्य हैं, तो आप देखेंगे कि आपका API key लागू हो गया है।
अब आप lookup endpoint का परीक्षण कर सकते हैं।

Lookup API endpoint — *नमूना Search Lookups (OAuth2)*

Postman

आप Postman के साथ भी यही कर सकते हैं।

Postman डाउनलोड करें ।
Lookup API पेज के शीर्ष से Download OpenAPI spec पर क्लिक करें।
इसे Postman में आयात करें।
यदि आपने इसे Wink API नामक एक नए कलेक्शन के रूप में आयात किया है, तो कलेक्शन नाम के बगल में क्षैतिज एलिप्सिस (3 डॉट) पर क्लिक करें और Edit पर क्लिक करें।
Authorization tab में, Auth type को OAuth2 पर सेट करें।
Add auth data to फ़ील्ड को Request headers पर सेट करें।
Header prefix फ़ील्ड को Bearer पर सेट करें।
Token Name फ़ील्ड को उस नाम पर सेट करें जिसे आप Postman में अपने सहेजे गए टोकन के लिए रखना चाहते हैं। जैसे कि Wink Staging।
Grant type फ़ील्ड को Client Credentials पर सेट करें।
Access token URL फ़ील्ड को https://staging-iam.wink.travel/oauth2/token पर सेट करें।
Client ID फ़ील्ड को उस Client ID पर सेट करें जो आपके ऐप ने उत्पन्न किया है।
Client Secret फ़ील्ड को उस Client Secret पर सेट करें जो आपके ऐप ने उत्पन्न किया है।
Scope फ़ील्ड को inventory.read inventory.write inventory.remove पर सेट करें। ये सभी स्कोप्स हैं जिनकी आपको Wink के लिए आवश्यकता होगी।
Client Authentication फ़ील्ड को Send as Basic Auth header पर सेट करें।
अपना टोकन प्राप्त करने और सहेजने के लिए Get New Access Token बटन पर क्लिक करें।
Wink API कलेक्शन के तहत सभी API कॉल्स के लिए, सुनिश्चित करें कि authentication tab में Inherit auth from parent लिखा हो ताकि यह हर कॉल के साथ आपका टोकन शामिल करे।