सेटअप

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

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

Wink पर अपना उपयोगकर्ता खाता Register करें।
Create an affiliate account। आपको इसे अपने Application से जोड़ने की आवश्यकता होगी। अधिक संदर्भ के लिए देखें what is Studio।
Create an Application करें और इसे चरण 2 में बनाए गए affiliate खाते से जोड़ें। सर्वर-टू-सर्वर API इंटीग्रेशन के लिए, क्लाइंट प्रकार के रूप में MACHINE_2_MACHINE चुनें।
एक बार जब आपने अपना Application बना लिया, तो तुरंत client-id और secret key कॉपी करके सुरक्षित कर लें — secret key केवल एक बार दिखाई जाती है और इसे फिर से प्राप्त नहीं किया जा सकता।

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 — *Sample Search Lookups (OAuth2)*

Postman

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

Postman डाउनलोड करें।
Lookup API पेज के शीर्ष से Download OpenAPI spec पर क्लिक करें।
इसे Postman में आयात करें।
यदि आपने इसे Wink API नामक एक नए संग्रह के रूप में आयात किया है, तो संग्रह नाम के बगल में क्षैतिज एलिप्सिस (3 डॉट) पर क्लिक करें और Edit पर क्लिक करें।
Authorization टैब में, 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 टैब कहता है Inherit auth from parent ताकि यह हर कॉल के साथ आपका टोकन शामिल करे।