इसे छोड़कर कंटेंट पर जाएं
Wink

सेटअप

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

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

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

CDN

Section titled “CDN”

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

हमारा cloud_name है traveliko।

Cloudinary

Section titled “Cloudinary”

उदाहरण

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"
    }
  ]
}

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

परीक्षण

Section titled “परीक्षण”

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

API दस्तावेज़

Section titled “API दस्तावेज़”

हमारी डाक्यूमेंटेशन साइट इस तरह सेटअप है कि आप साइट के भीतर से ही API कमांड चला सकते हैं।

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

  1. गंतव्य या होटलों को प्राप्त करने के लिए Lookup API का उपयोग करें।
  2. बाएं नेवबार में, Authentication पर क्लिक करें।
  3. अपना client-id और client secret दर्ज करें और Get TOKEN बटन पर क्लिक करें।
  4. यदि आपकी क्रेडेंशियल्स मान्य हैं, तो आप देखेंगे कि आपका API key लागू हो गया है।
  5. अब आप lookup endpoint का परीक्षण कर सकते हैं।
Lookup API endpoint
नमूना Search Lookups (OAuth2)

Postman

Section titled “Postman”

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

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