पार्टनर API

Wink Partner API एक प्रमाणीकृत, उच्च-थ्रूपुट तरीका है जो इंटीग्रेटर्स को बुक करने योग्य यात्रा इन्वेंट्री क्वेरी करने देता है — वही सप्लाई जो हमारे एम्बेडेबल विजेट्स और सार्वजनिक ब्राउज़ एंडपॉइंट्स को संचालित करती है, एक प्रथम श्रेणी प्रोग्रामेटिक इंटरफ़ेस के रूप में उपलब्ध। जहां मुफ्त वेब कॉम्पोनेंट्स और सार्वजनिक ब्राउज़ एंडपॉइंट्स हल्के, मानव-समक्ष एम्बेडिंग के लिए हैं, Partner API उन सिस्टमों के लिए बनाया गया है जो पैमाने पर खोज, मूल्य निर्धारण और बुकिंग करते हैं। एक्सेस प्रत्येक इंटीग्रेटर के लिए प्रमाणीकृत होता है और उपयोग के अनुसार बिल किया जाता है, इसलिए आप केवल उस ट्रैफ़िक के लिए भुगतान करते हैं जो आप वास्तव में भेजते हैं।

योजनाएं और मूल्य निर्धारण

उपयोग को होटल-रातों में मापा जाता है: एक होटल की एक रात के ठहराव के लिए मूल्य निर्धारण — एक API कॉल नहीं। एक खोज जो 3 रातों के ठहराव के लिए 20 होटल लौटाती है, वह एक अनुरोध से 60 होटल-रातें होती हैं। कंटेंट और लुकअप (गंतव्य खोज और ऑटोकंप्लीट) कॉल अपवाद हैं: प्रत्येक कॉल की लागत एक यूनिट होती है, चाहे वह कुछ भी लौटाए। खाता एंडपॉइंट्स मुफ्त हैं। मूल्य निर्धारण दर का स्रोत है।

	मुफ्त	भुगतान किया गया	एंटरप्राइज
मूल्य	$0	उपयोग-आधारित	संपर्क करें
सर्वोत्तम के लिए	मूल्यांकन और कम-आयतन इंटीग्रेशन	पैमाने पर उपयोग के अनुसार भुगतान	कस्टम वॉल्यूम और बातचीत की शर्तें
प्रति माह यूनिट्स	10,000	असीमित	असीमित
API प्रतिक्रिया समय (P95)	—	500 ms से कम	500 ms से कम
प्रति यूनिट मूल्य (होटल-रात)	मुफ्त	$0.0001	कस्टम
मासिक भत्ता पर प्रतिक्रिया	अगले महीने की 1 तारीख तक 429 (UTC)	बिल किया गया, अवरुद्ध नहीं	समझौते के अनुसार
सेवा स्तर समझौता	—	✓	✓
प्राथमिकता समर्थन	—	✓	✓
समर्पित ऑनबोर्डिंग	—	—	✓

API कुंजी प्राप्त करें · मापित बिलिंग शुरू करें · सेल्स से संपर्क करें

API संदर्भ

दो सतहें बुक करने योग्य इन्वेंट्री प्रदान करती हैं, और वे ऊपर दिए गए दो स्तरों से मेल खाती हैं:

• मुफ्त — कंज्यूमर / बुकिंग इंजन API (REST, /api/public/**): गुमनाम, ब्राउज़र और विजेट-फेसिंग। बुकिंग इंजन संदर्भ ब्राउज़ करें →
• भुगतान किया गया — पार्टनर इंटीग्रेटर API (gRPC, wink.partner.v1): प्रमाणीकृत, उपयोग-आधारित, पैमाने पर सर्वर-से-सर्वर इंटीग्रेशन के लिए बनाया गया। इंटीग्रेटर संदर्भ ब्राउज़ करें →

Partner Integrator API gRPC है, REST नहीं। आप इसे HTTP/2 पर एक जनरेटेड क्लाइंट के साथ कॉल करते हैं partner.wink.travel:443, एक बीयरर टोकन और उस खाते के साथ जिसे आप कॉल कर रहे हैं:

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

ऊपर दिया गया संदर्भ पृष्ठ हर सेवा, संदेश और त्रुटि स्थिति का दस्तावेज़ीकरण करता है, और स्कीमा रनटाइम पर सर्वर रिफ्लेक्शन के माध्यम से भी उपलब्ध है, इसलिए grpcurl, Postman और Insomnia इसे बिना डाउनलोड किए खोज लेते हैं।

यदि आप पहले से क्लाइंट जनरेट करना चाहते हैं, तो .proto स्रोत फ़ाइलें प्रकाशित हैं github.com/wink-travel/partner-api-proto पर।

उपयोग और सीमाएं कैसे काम करती हैं

मुफ्त स्तर

मुफ्त स्तर आपको बिना किसी लागत के मामूली उत्पादन ट्रैफ़िक बनाने, परीक्षण करने और चलाने के लिए डिज़ाइन किया गया है।

• प्रति मिनट कोई प्रकाशित सीमा नहीं। Wink अनुरोध दरों की निगरानी करता है और सेवा की सुरक्षा के लिए उचित-उपयोग सीमाएं लागू कर सकता है। यदि आपको HTTP 429 (बहुत अधिक अनुरोध) मिलता है, तो पुनः प्रयास करने से पहले Retry-After हेडर में दिए गए सेकंडों की प्रतीक्षा करें।
• मासिक भत्ता — प्रति कैलेंडर माह 10,000 यूनिट। भत्ता प्रति खाता दिया जाता है और हर महीने की 1 तारीख (UTC) को रीसेट होता है। एक बार जब आप इसे पार कर लेते हैं, तो जो खाता पे-एज़-यू-गो बिलिंग में नामांकित नहीं है उसे अगले महीने की 1 तारीख तक HTTP 429 प्राप्त होता है — एक कड़ा रोक, जिसमें Retry-After हेडर और भुगतान किए गए स्तर की सदस्यता लेने का संदेश होता है। नामांकित खाता काम करता रहता है और भत्ते से अधिक उपयोग के लिए बिल किया जाता है।

मुफ्त स्तर में सेवा स्तर समझौता या प्राथमिकता समर्थन शामिल नहीं है।

भुगतान किया गया स्तर

भुगतान किया गया स्तर मासिक सीमा को हटा देता है और आप केवल उपयोग के लिए बिल करते हैं।

• मापित होटल-रातें — प्रति होटल-रात $0.0001। कोई मासिक सीमा नहीं है; आप वास्तविक मात्रा पर बिल किए जाते हैं। Wink सेवा की सुरक्षा के लिए अभी भी उचित-उपयोग सीमाएं लागू कर सकता है। खोज और इन्वेंट्री कॉल प्रति होटल-रात मूल्य निर्धारण पर बिल करते हैं; कंटेंट और लुकअप कॉल प्रत्येक एक यूनिट बिल करते हैं, इसलिए अपने अनुरोधों को बैच करना बिल को कम रखता है।

भुगतान किया गया स्तर नीचे वर्णित सेवा स्तर समझौता शामिल करता है — 99.9% अपटाइम प्रतिबद्धता और 500 ms से कम P95 प्रतिक्रिया समय लक्ष्य — और प्राथमिकता, गंभीरता-आधारित समर्थन।

सेवा स्तर समझौता

प्रभावी तिथि: 5 जुलाई 2026 · संस्करण 1.0

यह सेवा स्तर समझौता (“SLA”) उपलब्धता प्रतिबद्धता, सेवा क्रेडिट और समर्थन लक्ष्यों को निर्धारित करता है जो Wink (“Wink”, “हम”, “हमें”) एक ग्राहक (“ग्राहक”, “आप”) को प्रमाणीकृत Wink पार्टनर API (“Partner API” या “सेवा”) के लिए प्रदान करता है, उन स्तरों पर जहां SLA लागू होता है। यह SLA उस समझौते (“समझौता”) में शामिल है और उसके अधीन है जिसके तहत आप Partner API तक पहुंचते हैं, और तब तक लागू रहता है जब तक आप एक सक्रिय, भुगतान किए गए Partner API सदस्यता को अच्छी स्थिति में बनाए रखते हैं। यहां परिभाषित नहीं किए गए पूंजीकृत शब्दों का अर्थ समझौते में दिया गया है।

1. परिभाषाएं

1. “अपटाइम” का अर्थ है वे अवधि जिनमें Partner API उपलब्ध होता है ताकि सही ढंग से बनाए गए, प्रमाणीकृत अनुरोधों को स्वीकार और सफलतापूर्वक प्रतिक्रिया दे सके।
2. “डाउनटाइम” का अर्थ है कोई भी अवधि, मिनटों में मापा गया, जिसमें Partner API सही ढंग से बनाए गए, प्रमाणीकृत अनुरोधों का सफलतापूर्वक जवाब देने में विफल रहता है, सिवाय उन अवधि के जो अनुभाग 4 में उल्लिखित अपवादों के अंतर्गत आते हैं। अनुरोधों के एक नगण्य हिस्से को प्रभावित करने वाली अलग-थलग त्रुटियां स्वयं में डाउनटाइम नहीं हैं।
3. “मासिक अपटाइम प्रतिशत” का अर्थ है, किसी दिए गए कैलेंडर महीने के लिए, उस महीने के कुल मिनटों में से कुल डाउनटाइम मिनट घटाकर, उसे कुल मिनटों से विभाजित कर प्रतिशत के रूप में व्यक्त किया गया।
4. “निर्धारित रखरखाव” का अर्थ है सेवा का नियोजित रखरखाव जिसके लिए Wink ने अनुभाग 4 के अनुसार पूर्व सूचना दी है।
5. “सेवा क्रेडिट” का अर्थ है एक क्रेडिट, जो उस कैलेंडर महीने में आपके द्वारा भुगतान किए गए या देय Partner API शुल्क का प्रतिशत होता है, जो अपटाइम प्रतिबद्धता पूरी न होने पर भविष्य के Partner API शुल्कों के विरुद्ध लागू किया जाता है और एकमात्र और विशेष उपचार होता है।
6. “प्रतिक्रिया समय” का अर्थ है Wink की सेवा सीमा पर Wink द्वारा सही ढंग से बनाए गए, प्रमाणीकृत अनुरोध प्राप्त करने और Wink द्वारा प्रतिक्रिया लौटाना शुरू करने के बीच का बीता समय, नेटवर्क ट्रांज़िट और Wink के नियंत्रण से बाहर क्लाइंट-साइड समय को छोड़कर।

2. उपलब्धता और प्रदर्शन प्रतिबद्धता

Wink वाणिज्यिक रूप से उचित प्रयास करेगा कि Partner API को प्रत्येक कैलेंडर महीने के दौरान मासिक अपटाइम प्रतिशत कम से कम 99.9% पर उपलब्ध कराए (जिसे “अपटाइम प्रतिबद्धता” कहा जाता है)। अपटाइम प्रतिबद्धता Wink की सेवा सीमा पर मापी जाती है और Wink के उचित नियंत्रण से बाहर के कारकों को छोड़ती है, जिनका वर्णन अनुभाग 4 में है। Wink की निगरानी प्रणालियां मासिक अपटाइम प्रतिशत और प्रतिक्रिया समय मापने के लिए प्राधिकृत रिकॉर्ड स्रोत हैं।

Wink सफल, सही ढंग से बनाए गए, प्रमाणीकृत अनुरोधों के लिए प्रत्येक कैलेंडर महीने में Wink की सेवा सीमा पर 95वें प्रतिशतक (P95) प्रतिक्रिया समय 500 मिलीसेकंड से कम रखने का लक्ष्य रखता है (“प्रदर्शन लक्ष्य”)। प्रदर्शन लक्ष्य अनुभाग 4 में वर्णित कारकों, स्वयं अनुरोध से उत्पन्न एप्लिकेशन-स्तर त्रुटियों वाले अनुरोधों, और असामान्य रूप से बड़े या जटिल बैच अनुरोधों को छोड़ता है। प्रदर्शन लक्ष्य एक सेवा उद्देश्य है; अनुभाग 3 में सेवा क्रेडिट केवल अपटाइम प्रतिबद्धता पूरी न होने पर लागू होते हैं और उपलब्धता की कमी के लिए एकमात्र और विशेष उपचार हैं।

3. सेवा क्रेडिट

यदि मासिक अपटाइम प्रतिशत किसी भी कैलेंडर महीने में अपटाइम प्रतिबद्धता से नीचे गिरता है, तो आप उस महीने के लिए आपके द्वारा भुगतान किए गए या देय Partner API शुल्क का प्रतिशत के रूप में सेवा क्रेडिट के पात्र हो सकते हैं, निम्नलिखित स्तर के अनुसार:

मासिक अपटाइम प्रतिशत	सेवा क्रेडिट
99.9% से नीचे लेकिन 99.0% या उससे ऊपर	10%
99.0% से नीचे लेकिन 95.0% या उससे ऊपर	25%
95.0% से नीचे	50%

1. क्रेडिट का दावा करना। सेवा क्रेडिट प्राप्त करने के लिए आपको उस कैलेंडर महीने के अंत से तीस (30) दिनों के भीतर Wink को लिखित दावा प्रस्तुत करना होगा जिसमें कमी हुई थी। दावा में प्रत्येक डाउनटाइम घटना की तिथियां और समय शामिल होने चाहिए और कोई भी समर्थन लॉग या प्रमाण जो आपके लिए उचित रूप से उपलब्ध हो। इस विंडो के बाद प्रस्तुत किए गए दावे पात्र नहीं होंगे।
2. क्रेडिट का रूप। स्वीकृत सेवा क्रेडिट भविष्य के Partner API शुल्कों के विरुद्ध लागू होते हैं और उनका कोई नकद मूल्य नहीं होता। वे रिफंड नहीं हैं और केवल लागू कानून द्वारा आवश्यक होने पर ही भुगतान किए जाएंगे।
3. अधिकतम क्रेडिट। किसी भी एकल कैलेंडर महीने के लिए प्रदान किए गए कुल सेवा क्रेडिट आपके द्वारा उस महीने के लिए भुगतान किए गए या देय Partner API शुल्क का 50% से अधिक नहीं होगा।
4. एकमात्र और विशेष उपचार। सेवा क्रेडिट Wink द्वारा अपटाइम प्रतिबद्धता पूरी न करने या Partner API की किसी भी अन्य उपलब्धता कमी के लिए आपका एकमात्र और विशेष उपचार हैं।

4. अपवाद

अपटाइम प्रतिबद्धता और किसी भी परिणामी सेवा क्रेडिट उन अनुपलब्धता, निलंबन, गिरावट, या प्रदर्शन समस्या पर लागू नहीं होते, और डाउनटाइम में शामिल नहीं हैं, जो निम्न कारणों से उत्पन्न या संबंधित हैं:

1. Wink द्वारा पूर्व सूचना के साथ किया गया निर्धारित रखरखाव, बशर्ते ऐसी सूचना Wink द्वारा ग्राहकों से संवाद करने के लिए सामान्यतः उपयोग किए जाने वाले चैनल के माध्यम से उचित अवधि पहले दी गई हो;
2. फोर्स मेज्योर घटनाएं या Wink के उचित नियंत्रण से बाहर अन्य कारण, जिनमें प्राकृतिक आपदाएं, सरकारी कार्य, नेटवर्क या उपयोगिता विफलताएं, और डिनायल-ऑफ-सर्विस या अन्य दुर्भावनापूर्ण हमले शामिल हैं;
3. आपकी क्रियाओं या चूक, आपके उपकरण, सॉफ़्टवेयर, या नेटवर्क, या किसी भी तीसरे पक्ष की सेवा, उत्पाद, या प्रदाता के कारण उत्पन्न मुद्दे जो Wink के सीधे नियंत्रण में नहीं हैं;
4. आपकी सेवा का दुरुपयोग या समझौते, इस SLA, स्वीकार्य-उपयोग शर्तों, या लागू दर सीमाओं का उल्लंघन, जिसमें ट्रैफ़िक जो Wink उचित रूप से अत्यधिक मानता है, स्वचालित दुरुपयोग, या धोखाधड़ी शामिल हैं; और
5. आपके एक्सेस का कोई भी निलंबन या समाप्ति जो समझौते के तहत उचित रूप से लागू किया गया हो, जिसमें गैर-भुगतान के कारण निलंबन शामिल है।

5. समर्थन और प्रतिक्रिया लक्ष्य

Wink मानक कार्य समय के दौरान Partner API के लिए समर्थन प्रदान करता है, स्थानीय सार्वजनिक छुट्टियों को छोड़कर। Wink उचित वाणिज्यिक प्रयास करेगा कि सही ढंग से प्रस्तुत समर्थन अनुरोधों को निम्नलिखित लक्षित प्रतिक्रिया समय के भीतर स्वीकार किया जाए, जो आप द्वारा सौंपे गए गंभीरता स्तर और Wink द्वारा उचित रूप से पुष्टि किए गए हैं:

गंभीरता	विवरण	लक्षित प्रारंभिक प्रतिक्रिया
Sev 1 — गंभीर	Partner API डाउन है या उत्पादन में उपयोग के लिए अनुपयोगी है, कोई समाधान नहीं है।	4 घंटे
Sev 2 — प्रमुख	महत्वपूर्ण फीचर प्रभावित या गिरा हुआ है; समाधान मौजूद है।	1 कार्य दिवस
Sev 3 — मामूली	सामान्य प्रश्न, मामूली मुद्दे, या फीचर अनुरोध।	2 कार्य दिवस

लक्षित प्रतिक्रिया समय यह दर्शाते हैं कि Wink प्रारंभिक संपर्क कब करना चाहता है; ये समाधान समय की गारंटी नहीं हैं। प्राथमिकता समर्थन और गंभीरता-आधारित लक्ष्य उन स्तरों पर लागू होते हैं जहां इन्हें शामिल बताया गया है।

6. डेटा और सुरक्षा

Wink वाणिज्यिक रूप से उचित प्रशासनिक, तकनीकी, और संगठनात्मक उपाय बनाए रखता है जो Partner API के माध्यम से संसाधित डेटा की गोपनीयता, अखंडता, और उपलब्धता की सुरक्षा के लिए डिज़ाइन किए गए हैं, और उन उपायों की समय-समय पर समीक्षा करता है। Wink का व्यक्तिगत डेटा प्रसंस्करण गोपनीयता नीति और समझौते में किसी भी डेटा-प्रसंस्करण शर्तों द्वारा शासित है। आप अपनी API क्रेडेंशियल्स की सुरक्षा के लिए जिम्मेदार रहते हैं, किसी भी डेटा के कानूनी उपयोग के लिए, और किसी भी संदिग्ध क्रेडेंशियल समझौते की शीघ्र सूचना Wink को देने के लिए।

7. दायित्व की सीमा

सेवा क्रेडिट किसी भी अनुपलब्धता या अपटाइम प्रतिबद्धता पूरी न करने के लिए आपका एकमात्र और विशेष उपचार हैं, और ऐसी विफलता से उत्पन्न किसी अन्य दायित्व के स्थान पर प्रदान किए जाते हैं। इस SLA में स्पष्ट रूप से उल्लिखित के अलावा, Partner API “जैसा उपलब्ध हो” आधार पर प्रदान किया जाता है। लागू कानून द्वारा अधिकतम सीमा तक, Wink की सेवा से उत्पन्न या संबंधित कुल दायित्व समझौते में निर्धारित सीमा तक सीमित है, और Wink किसी भी अप्रत्यक्ष, आकस्मिक, विशेष, परिणामी, या दंडात्मक हानि के लिए, या खोए हुए लाभ, राजस्व, डेटा, या सद्भावना के लिए उत्तरदायी नहीं है, भले ही ऐसी हानियों की संभावना के बारे में सूचित किया गया हो।

8. अवधि, परिवर्तन और समाप्ति

यह SLA तब तक लागू होता है जब तक आपके पास उस स्तर पर सक्रिय Partner API सदस्यता है जहां SLA लागू होता है। Wink समय-समय पर इस SLA को अपडेट कर सकता है; महत्वपूर्ण परिवर्तन Wink द्वारा ग्राहकों तक पहुंचने के लिए सामान्यतः उपयोग किए जाने वाले चैनल के माध्यम से संप्रेषित किए जाएंगे, और अपडेट लागू होने के बाद Partner API का निरंतर उपयोग अपडेटेड SLA को स्वीकार करने के रूप में माना जाएगा। यह SLA समझौते या आपकी Partner API सदस्यता की समाप्ति या अवधि समाप्ति पर स्वतः समाप्त हो जाता है। वे अनुभाग जो स्वाभाविक रूप से समाप्ति के बाद भी जीवित रहना चाहिए — जिसमें अर्जित लेकिन दावा न किए गए सेवा क्रेडिट पात्रता, दायित्व की सीमा, और परिभाषाएं शामिल हैं — जीवित रहते हैं।