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

एप्लिकेशन

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

नमूना एप्लिकेशन
नमूना एप्लिकेशन प्रविष्टि
  1. Accounts से उस खाते का चयन करें जिसके साथ आप काम करना चाहते हैं।
  2. खाते के कार्ड के नीचे Actions पर क्लिक करें और Manage account चुनें।
  3. अगली पृष्ठ पर Applications टैब पर क्लिक करें।
  4. यह अनुभाग आपके सभी एप्लिकेशन सूचीबद्ध करेगा।
  5. किसी मौजूदा एप्लिकेशन को रोटेट या हटाएं, या नया बनाएं।

चूंकि आप हमारे द्वारा बनाए गए ऐप की secret key तक पहुंच नहीं सकते, इसलिए आपको अपना खुद का बनाना होगा।
आप यहां बिना किसी प्रॉपर्टी या कंपनी सेटअप किए एप्लिकेशन बना सकते हैं — यह किसी विशिष्ट खाते से बंधा नहीं है।

एप्लिकेशन बनाते समय, आप एक क्लाइंट प्रकार चुनते हैं जो निर्धारित करता है कि ऐप कैसे प्रमाणित होता है।
यह बाद में बदला नहीं जा सकता — यदि आपको अलग प्रकार चाहिए, तो नया एप्लिकेशन बनाएं।

  • वेब एप्लिकेशन — एक सर्वर-रेंडर की गई ऐप जो सुरक्षित रूप से क्लाइंट सीक्रेट रख सकती है (ऑथराइजेशन कोड फ्लो)।
  • सिंगल-पेज ऐप (SPA) — बिना बैकएंड वाला ब्राउज़र ऐप; PKCE का उपयोग करता है, बिना क्लाइंट सीक्रेट के।
  • मोबाइल ऐप — एक नेटिव iOS/Android ऐप; PKCE का उपयोग करता है जिसमें रोटेटिंग रिफ्रेश टोकन होते हैं।
  • मशीन-टू-मशीन — एक बैकएंड सेवा जो स्वयं के रूप में कार्य करती है (क्लाइंट क्रेडेंशियल्स); कोई उपयोगकर्ता साइन-इन नहीं।

यहाँ एप्लिकेशन बनाने के चरण हैं:

  1. ऐप्स पेज से, Create new application बटन पर क्लिक करें।
  2. नाम अपने ऐप को एक नाम दें। जैसे Cool App
  3. क्लाइंट प्रकार उस प्रकार को चुनें जो आपके ऐप के प्रमाणन से मेल खाता हो — ऊपर Client types देखें।
  4. Redirect URIs कम से कम एक रीडायरेक्ट URI आवश्यक है। यह सफल प्रमाणन के बाद रीडायरेक्ट डोमेन को मान्य करने के लिए उपयोग किया जाता है। मशीन-टू-मशीन ऐप्स के लिए उपयोग नहीं होता। जैसे https://www.cool-site.com
  5. Post-logout redirect URIs (वैकल्पिक) लॉगआउट के बाद उपयोगकर्ताओं को रीडायरेक्ट करने के लिए URL। ऊपर दिए गए रीडायरेक्ट URIs को पुनः उपयोग करने के लिए खाली छोड़ दें।
  6. Scopes चुनें कि यह एप्लिकेशन आपकी ओर से क्या एक्सेस कर सकता है — नीचे Choosing scopes देखें।
  7. जारी रखने के लिए Create application बटन पर क्लिक करें।

आपको आपके एप्लिकेशन की सूची पर वापस ले जाया जाएगा, और एक बार के लिए एक संवाद बॉक्स नया Client ID और Client secret दिखाएगा।
अब सीक्रेट को कॉपी करें और कहीं सुरक्षित रखें — इसे फिर कभी नहीं दिखाया जाएगा, और बाद में पुनः प्राप्त करने का कोई तरीका नहीं है (केवल rotate किया जा सकता है)।

हर एप्लिकेशन में हमेशा Sign-in (OpenID Connect) स्कोप्स (openid, profile, email, offline_access) होते हैं — ये उपयोगकर्ता की पहचान की पुष्टि करते हैं और उन्हें साइन-इन बनाए रखते हैं, इसलिए ये चेक और लॉक किए हुए दिखते हैं; ये विकल्प नहीं हैं।

बाकी सब ऑप्ट-इन हैं। शेष स्कोप्स को उसी कार्यात्मक वर्गों में समूहित किया गया है जो Scopes में दस्तावेजीकृत हैं — खाता, इन्वेंटरी और दरें, बुकिंग, मार्केटिंग और प्रचार, प्रॉपर्टी सामग्री, एनालिटिक्स और रिपोर्ट, चैनल मैनेजर इंटीग्रेशन, भुगतान, और अकाउंटिंग और लेजर — प्रत्येक के साथ यह स्पष्ट किया गया है कि वे क्या अनलॉक करते हैं। सूची के ऊपर All / None लिंक का उपयोग करके सभी वैकल्पिक स्कोप्स को एक साथ चुनें या साफ़ करें।

इस फॉर्म पर दो स्कोप परिवार जानबूझकर प्रस्तुत नहीं किए गए हैं:

  • mcp.* — AI-एजेंट को Model Context Protocol ट्रांसपोर्ट तक पहुंच। आप इसके लिए एप्लिकेशन नहीं बनाते: Claude, ChatGPT या Codex जैसे AI क्लाइंट स्वयं पंजीकरण करते हैं और MCP सहमति स्क्रीन के माध्यम से साइन-इन करते समय ये स्कोप्स मांगते हैं। इन्हें मशीन-टू-मशीन ऐप्स को कभी नहीं दिया जाता क्योंकि MCP हमेशा साइन-इन किए गए उपयोगकर्ता की ओर से कार्य करता है।
  • प्रशासक-स्तरीय स्कोप्स (administrator.*) — प्लेटफ़ॉर्म-स्तरीय पहुंच जो प्रति एप्लिकेशन नहीं दी जाती।

एक बार ऐप बनने के बाद, यह टैब और Consented Apps दोनों उसके दिए गए स्कोप्स को वर्गीकृत करके दिखाते हैं (जैसे “Bookings: booking.read”), ताकि आप बिना खोलें ही देख सकें कि ऐप क्या कर सकता है।

क्रेडेंशियल्स रोटेट करें

Section titled “क्रेडेंशियल्स रोटेट करें”

यदि क्लाइंट सीक्रेट लीक हो गया हो, या आप बस नए क्रेडेंशियल्स चाहते हों, तो ऐप को पुनः बनाने के बजाय उन्हें रोटेट करें:

  1. अपनी एप्लिकेशन सूची में ऐप खोजें और Rotate पर क्लिक करें।
  2. संवाद की पुष्टि करें — वर्तमान Client ID और सीक्रेट तुरंत काम करना बंद कर देंगे।
  3. संवाद बंद करने से पहले नए Client ID और सीक्रेट को कॉपी करें।

रोटेट करने से ऐप का नाम, क्लाइंट प्रकार, रीडायरेक्ट URIs, और स्कोप्स वैसे ही रहते हैं — केवल क्रेडेंशियल्स बदलते हैं।

यदि आपको किसी ऐप की अब आवश्यकता नहीं है, तो आप इसे हटा सकते हैं। यह स्थायी है — क्रेडेंशियल्स तुरंत रद्द कर दिए जाते हैं और पुनः प्राप्त नहीं किए जा सकते।

  1. अपनी एप्लिकेशन सूची में ऐप खोजें और Delete पर क्लिक करें।
  2. एप्लिकेशन को स्थायी रूप से हटाने के लिए संवाद की पुष्टि करें।