API या डैशबोर्ड से कोसोवो SMS OTP कोड कैसे पाएँ

किसी प्रोडक्ट टीम को +383 नंबर की ज़रूरत ही क्यों पड़ेगी?

कोसोवो छोटा बाज़ार है, पर विदेश में उसकी मौजूदगी बड़ी है: जर्मनी, स्विट्ज़रलैंड और पश्चिमी यूरोप के अन्य हिस्सों में बड़ा प्रवासी समुदाय रहता है, और उनमें से कई परिवार और बैंकिंग के लिए कोसोवो का नंबर रखते हैं। जो ऐप इस दर्शक वर्ग को सेवा देते हैं, यात्रा से लेकर मनी ट्रांसफ़र तक, उन्हें देखना होता है कि +383 यूज़र को साइन-अप पर क्या अनुभव मिलता है।

लोकलाइज़ेशन दूसरी वजह है। अल्बानियाई और सर्बियाई, दोनों आधिकारिक हैं, इसलिए किसी भी भाषा में अनूदित फ़्लो को स्क्रीनशॉट समीक्षा की जगह असली शुरू-से-अंत टेस्ट मिलना चाहिए। OTP Gateway का कोसोवो वेरिफ़िकेशन नंबर QA को किसी भी दफ़्तर से वह जाँच चलाने देता है।

प्रिश्तिना में बैठी या व्यापक पश्चिमी बाल्कन को कवर करने वाली क्षेत्रीय संचालन टीमों के पास तीसरा कारण है: स्थानीय संपर्क के साथ रजिस्टर्ड बिज़नेस प्रोफ़ाइल कभी-कभी नया कोड माँगते हैं, और उसे साझा, ऑडिट-योग्य टूल से गुज़ारना किसी कर्मचारी का हैंडसेट इधर-उधर घुमाने से बेहतर है।

कोसोवो रूट पर अभी कौन-से ऐप हैं?

आज का स्नैपशॉट कोसोवो के लिए 400 से ज़्यादा सेवाएँ दिखाता है। अभी उपलब्ध लोकप्रिय नामों में WhatsApp, Viber, Telegram, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Snapchat, Netflix, Airbnb, Uber और Flipkart हैं।

सूची बड़े यूरोपीय बाज़ारों से छोटी है और ज़्यादा बार बदलती है, इसलिए किसी भी लिखी हुई सूची को संकेत भर मानें। प्रामाणिक जवाब वही है जो ऑर्डर के पल GET /api/v1/countries और डैशबोर्ड लौटाते हैं।

व्यवहार में कोसोवो OTP API के साथ काम करना

country id xk है। एक सामान्य इंटीग्रेशन GET /api/v1/services से सेवा id तय करता है, GET /api/v1/prices?country=xk&service=<id> से लागत जाँचता है, और फिर POST /api/v1/activations से activation खोलता है, जिसकी बॉडी {"service": "telegram", "country": "xk"} जैसी होती है। रिस्पॉन्स में नंबर और एक activation id मिलता है जिसे आप आगे के लिए रखते हैं।

इसके बाद कोड आप तक activation.sms_received webhook के रूप में पहुँचता है, जिसे X-OTPRoute-Signature हेडर में "<t>.<raw body>" पर HMAC-SHA256 से साइन किया गया होता है। पुराने टाइमस्टैम्प ठुकराएँ, और अपना हैंडलर activation id पर आधारित रखें ताकि दोबारा आई डिलीवरी सिर्फ़ एक बार प्रोसेस हो। जब CI जॉब के पास सार्वजनिक URL न हो, तब GET /api/v1/activations/{id} को poll करना भी चलता है। पूरे उदाहरणों के लिए इंटीग्रेशन गाइड देखें।

कोसोवो को +383 मिलने पर क्या बदला, और नंबर कैसे स्टोर करें?

कोसोवो को अपना कंट्री कोड +383 2010 के दशक के अंत में ही मिला। उससे पहले उसके मोबाइल नेटवर्क उधार के कोड इस्तेमाल करते थे, जिनमें मोनाको और स्लोवेनिया के कोड शामिल थे, और कुछ पुराने ग्राहक रिकॉर्ड में अब भी उन्हीं फ़ॉर्मैट के नंबर हैं। अगर आप पुराना डेटा इम्पोर्ट कर रहे हैं, तो उन एंट्री को अपने-आप दोबारा लिखने की जगह फ़्लैग करें।

घरेलू नंबर ट्रंक प्रिफ़िक्स 0 से शुरू होते हैं; स्थानीय रूप में 044 123 456 दिखने वाला मोबाइल E.164 में +383 44 123 456 है। अंतरराष्ट्रीय रूप सेव करें, इनपुट पर शून्य हटाएँ, और फ़ॉर्मैट सिर्फ़ दिखाते समय करें। अल्बानियाई टेक्स्ट में ë जैसे अक्षर होते हैं जो बुनियादी GSM वर्णमाला से बाहर हैं, इसलिए लोकलाइज़्ड संदेश UCS-2 में छोटे सेगमेंट के साथ भेजा जा सकता है।

कोसोवो का कोड देर से या ग़ायब हो तो क्या होना चाहिए?

एक्टिवेशन को उसके पूरे 20 मिनट दें। विंडो बिना SMS के बंद हो जाए, या आप कैंसल कर दें, तो शुल्क अपने-आप वॉलेट में लौटा दिया जाता है और activation.expired या activation.cancelled इवेंट आता है। समझदारी भरे अगले क़दम:

• थोड़ा रुककर फिर कोशिश करें, या अगर आपका टेस्ट अनुमति दे तो अल्बानिया जैसा पड़ोसी रूट चुनें;
• जाँचें कि लक्षित सेवा वर्चुअल नंबर लेती भी है या नहीं;
• लूप में ऑर्डर देने की जगह ऑटोमेटेड रीट्राई में backoff जोड़ें।

कोसोवो प्रोजेक्ट के लिए लंबे समय वाली लाइनें, वॉलेट और sandbox

OTP Route के पास कोसोवो के लिए कोई सेल्फ़-सर्व लंबे समय वाला नंबर नहीं है। उसकी Dedicated Numbers लाइन, $1.95/month से, सिर्फ़ दो देशों को कवर करती है: संयुक्त राज्य अमेरिका और कनाडा। स्थायी +383 लाइन के लिए [email protected] पर ईमेल करें; व्यवस्था हो सकती है या नहीं, यह स्थानीय नियमों पर निर्भर है।

ख़र्च एक ही प्रीपेड USD वॉलेट से जाता है, पे-एज़-यू-गो, कार्ड या USDT/USDC से टॉप-अप, और हर टॉप-अप का PDF इनवॉइस ईमेल होता है। webhook जोड़ते समय सिमुलेटेड नंबर और कोड पाने के लिए डेवलपर्स डेवलपमेंट अकाउंट पर sandbox मोड माँग सकते हैं। विवरण pricing पर।

अक्सर पूछे जाने वाले प्रश्न

क्या मैं असली कोसोवो नंबर से अपने ऐप का अल्बानियाई-भाषा साइन-अप जाँच सकता हूँ?

हाँ। OTP Gateway में टेस्टिंग के लिए +383 नंबर ऑर्डर करें, अल्बानियाई में साइन-अप शुरू करें, और कोड डैशबोर्ड और आपके webhook में दिखेगा।

SMS वेरिफ़िकेशन API में कोसोवो कौन-सा id इस्तेमाल करता है?

country लेने वाले हर endpoint में कोसोवो xk है, जिनमें GET /api/v1/prices और POST /api/v1/activations शामिल हैं।

कोसोवो वेरिफ़िकेशन नंबर की क़ीमत कितनी है?

$0.20 प्रति कोड से; सटीक दर सेवा पर निर्भर करती है और ऑर्डर से पहले दिखाई जाती है, या prices endpoint लौटाता है।

कोसोवो के लिए जर्मनी से कम सेवाएँ क्यों दिखती हैं?

कवरेज इस पर चलती है कि हमारे कैरियर पार्टनर हर देश में क्या रूट कर सकते हैं, और छोटे बाज़ारों की सूचियाँ छोटी होती हैं। टेस्ट रन की योजना बनाने से पहले लाइव सूची जाँचें।

अगर कोसोवो के OTP कभी न आएँ तो मेरे पैसे का क्या होता है?

20 मिनट की विंडो बिना SMS के ख़त्म होते ही पूरी रक़म वॉलेट में लौट जाती है, या कैंसल करने पर तुरंत।

क्या पुराने +377 या +386 नंबर अब भी कोसोवो यूज़र्स के हैं?

कुछ पुराने रिकॉर्ड में वे हो सकते हैं, पर नए नंबर +383 इस्तेमाल करते हैं। पुराने फ़ॉर्मैट को आँख मूँदकर बदलने की जगह समीक्षा के योग्य डेटा मानें।

क्या बार-बार लॉगिन के लिए मैं +383 नंबर रख सकता हूँ?

सेल्फ़-सर्व नहीं। हर गेटवे नंबर एक कोड के लिए होता है, और लंबे समय वाली लाइनें अमेरिका/कनाडा का प्रोडक्ट हैं; कोसोवो के बारे में पूछने के लिए [email protected] पर ईमेल करें।

क्या OTP Route नंबरों का इस्तेमाल कैसे करें, इस पर कोई नियम हैं?

हाँ। OTP Route का इस्तेमाल सिर्फ़ अपने वैध प्रोडक्ट और बिज़नेस अकाउंट के लिए करें, हर सेवा की शर्तों का पालन करें, और Acceptable Use Policy का सम्मान करें। शुरू करने के लिए साइन अप करें।

सेवाओं के नाम उनके संबंधित स्वामियों के ट्रेडमार्क हैं। OTP Route का उनसे कोई संबंध नहीं है। नंबरों का उपयोग कानूनी रूप से करें तथा प्रत्येक सेवा की शर्तों और हमारी स्वीकार्य उपयोग नीति का पालन करें।