पार्टनर API

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

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

एक API कॉल = एक अनुरोध। मीटर किया गया उपयोग प्रति 1,000 अनुरोधों पर बिल किया जाता है।

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

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 पर प्रकाशित हैं।

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

मुफ्त स्तर

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

• दर सीमा — प्रति मिनट 30 अनुरोध, 60 अनुरोध का बर्स्ट। स्थिर दर से ऊपर के छोटे स्पाइक्स बर्स्ट भत्ता द्वारा अवशोषित होते हैं। यदि आप इसे पार करते हैं, तो API HTTP 429 (बहुत अधिक अनुरोध) के साथ प्रतिक्रिया देता है और आपकी कुंजी ट्रैफ़िक सेवा फिर से शुरू करने से पहले 5 मिनट का विराम लागू करता है। विराम विंडो के बाद पुनः प्रयास करें, एंडपॉइंट पर लगातार अनुरोध न करें।
• मासिक कोटा — प्रति कैलेंडर माह 10,000 अनुरोध। एक बार मासिक सीमा तक पहुंचने पर, API शेष महीने के लिए HTTP 429 लौटाता है — एक हार्ड स्टॉप — साथ ही एक संदेश जो आपको भुगतान किए गए स्तर की सदस्यता लेने के लिए आमंत्रित करता है। काउंटर अगले कैलेंडर महीने की शुरुआत में रीसेट हो जाता है।

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

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

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

• मीटर अनुरोध — प्रति 1,000 अनुरोध $1.00। कोई मासिक अनुरोध सीमा नहीं है और सामान्य उपयोग के तहत कोई दर-सीमा थ्रॉटलिंग नहीं है; आपको वास्तविक मात्रा पर बिल किया जाता है।

• लुक-टू-बुक ओवरएज — प्रति 1,000 अतिरिक्त लुक $2.00। सप्लाई को स्वस्थ रखने के लिए, हम खोजों (“लुक”) और पुष्टि की गई बुकिंग के अनुपात को मीटर करते हैं। आपको ओवरएज लागू होने से पहले प्रति बुकिंग 5,000 लुक मिलते हैं। अतिरिक्त लुक की गणना इस प्रकार होती है:

  excess = max(0, looks − bookings × 5,000)

  ओवरएज तब प्रति 1,000 अतिरिक्त लुक $2.00 पर बिल किया जाता है। जो इंटीग्रेशन अच्छी तरह से कन्वर्ट करते हैं, वे शायद ही कभी कोई ओवरएज लेते हैं; यह शुल्क केवल उस ट्रैफ़िक पर लागू होता है जो बुकिंग की तुलना में बहुत अधिक खोज करता है।

भुगतान किया गया स्तर नीचे वर्णित सेवा स्तर समझौता शामिल करता है — 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 के नियंत्रण से बाहर क्लाइंट-साइड समय को छोड़कर।

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 सदस्यता की समाप्ति या समाप्ति पर स्वचालित रूप से समाप्त हो जाता है। वे अनुभाग जो स्वाभाविक रूप से समाप्ति के बाद भी जीवित रहना चाहिए — जिसमें अर्जित लेकिन दावा न किए गए सेवा क्रेडिट पात्रता, दायित्व की सीमा, और परिभाषाएं शामिल हैं — जीवित रहते हैं।