एप्लिकेशन

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

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

ऐप बनाएं

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

क्लाइंट प्रकार

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

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

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

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

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

स्कोप चुनना

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

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

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

mcp.* — AI-एजेंट को Model Context Protocol ट्रांसपोर्ट तक पहुंच, जो अलग से प्रदान किया जाता है और केवल मशीन-टू-मशीन क्लाइंट्स के लिए है।
एडमिनिस्ट्रेटर-स्तरीय स्कोप्स (administrator.*) — प्लेटफ़ॉर्म-स्तरीय पहुंच जो प्रति एप्लिकेशन नहीं दी जाती।

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

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

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

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

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

ऐप हटाएं

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

अपनी एप्लिकेशन सूची में ऐप खोजें और Delete पर क्लिक करें।
एप्लिकेशन को स्थायी रूप से हटाने के लिए डायलॉग की पुष्टि करें।