Estonia OTP API चेकलिस्ट: QA के लिए +372 कोड

पहला +372 ऑर्डर देने से पहले चेकलिस्ट में क्या होना चाहिए?

ज़्यादातर नाकाम टेस्ट रन की जड़ नंबर माँगने से पहले की किसी छूटी हुई चीज़ में मिलती है। पहले इन्हें जाँच लें:

एक API कुंजी जो Developer console में बनी हो। हर कुंजी में or_live_ प्रीफ़िक्स होता है और वह Bearer टोकन के रूप में जाती है; एक अकाउंट में 10 की गुंजाइश है, इसलिए CI रनर की अपनी अलग कुंजी होनी चाहिए।
एक वेबहुक एंडपॉइंट, जिसका सीक्रेट सर्वर-साइड सुरक्षित हो, अगर आप पोल करने के बजाय कॉल पाना चाहते हैं। प्रति अकाउंट पाँच एंडपॉइंट की अनुमति है।
सही आईडी। हर अनुरोध में Estonia ee है, और सेवा की आईडी GET /api/v1/services से मिलती है।
लाइव कीमत की जाँच। GET /api/v1/prices?country=ee&service=<id> कॉल करें ताकि वॉलेट की राशि लगाने से पहले जॉब को लागत पता हो।
सैंडबॉक्स, अगर आप अभी जोड़-तोड़ कर रहे हैं। अनुरोध पर किसी डेवलपमेंट अकाउंट को सैंडबॉक्स मोड में बदला जा सकता है, जो आपके बैलेंस को छुए बिना शुरू से अंत तक सिम्युलेटेड नंबर और कोड लौटाता है।
रेट बजट। API प्रति अकाउंट प्रति मिनट 300 अनुरोध स्वीकार करता है, जो तब तक काफ़ी है जब तक टेस्ट सूट लापरवाही से पोल न करे।

OTP API इंटीग्रेशन गाइड इनमें से हर बिंदु को और विस्तार से समझाती है।

Estonia OTP API अनुरोध शुरू से अंत तक कैसे चलाऊँ?

चेकलिस्ट पूरी होने के बाद कॉल का क्रम छोटा है:

{"service": "<id>", "country": "ee"} बॉडी के साथ POST /api/v1/activations। जवाब में एक एक्टिवेशन आईडी और वह +372 नंबर आता है जिसे टेस्ट किए जा रहे साइन-अप या लॉगिन फ़ॉर्म में डालना है।
जिस ऐप को आप टेस्ट कर रहे हैं, उससे सत्यापन SMS ट्रिगर करें।
कोड का इंतज़ार करें। या तो आपके एंडपॉइंट को activation.sms_received मिलेगा, या आप किसी उचित अंतराल पर GET /api/v1/activations/{id} कॉल करें।
ऐप में कोड सबमिट करें और नतीजा एक्टिवेशन आईडी के सामने दर्ज करें।
यदि टेस्ट का रास्ता बदल जाए और नंबर की ज़रूरत न रहे, तो POST /api/v1/activations/{id}/cancel कॉल करें ताकि होल्ड तुरंत हट जाए।

वेबहुक डिलीवरी के लिए X-OTPRoute-Signature हेडर (t=<unix>,v1=<hex>) पढ़ें, एंडपॉइंट सीक्रेट के साथ <t>.<raw body> पर HMAC-SHA256 निकालें, कॉन्स्टेंट टाइम में मिलान करें, और पुराने टाइमस्टैम्प वाली हर चीज़ छोड़ दें। HMAC से OTP वेबहुक सुरक्षित करना एक रेफ़रेंस हैंडलर के साथ पूरी प्रक्रिया बताता है। राइट को एक्टिवेशन आईडी पर idempotent रखें, क्योंकि रीट्राई में वही इवेंट दो बार आ सकता है।

कौन-सी सेवाएँ एस्टोनियाई सत्यापन नंबर पर कोड भेज सकती हैं?

Estonia का लाइव स्नैपशॉट 1,700 से अधिक सेवाएँ दिखाता है। लोकप्रिय रूट में WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, LinkedIn, Microsoft & Outlook, Amazon, Discord, Signal, Uber, Airbnb और ChatGPT (OpenAI) शामिल हैं।

इन्वेंटरी दिन भर बदलती है, इसलिए जो रूट सुबह जवाब दे रहा था, शाम तक कमज़ोर पड़ सकता है। अपने टेस्ट फ़िक्स्चर में सूची हार्ड-कोड करने के बजाय GET /api/v1/countries और प्राइस एंडपॉइंट को ही अंतिम स्रोत मानें।

+372 नंबर कैसे स्टोर और वैलिडेट करें?

एस्टोनिया की नंबरिंग योजना संभालने में आसान है, और यही कारण है कि लापरवाही से लिखे वैलिडेटर इस पर टूट जाते हैं। हटाने के लिए कोई ट्रंक प्रीफ़िक्स नहीं है: घरेलू रूप में लिखा नंबर वही अंक हैं जो +372 के बाद जुड़ते हैं। मोबाइल नंबर आम तौर पर 5 से शुरू होते हैं और सात या आठ अंकों के होते हैं, इसलिए राष्ट्रीय लंबाई को स्थिर मानने वाला regex वैध इनपुट को भी ठुकरा देगा।

आपके फ़ॉर्म और डेटाबेस के लिए व्यावहारिक नियम:

पूरा E.164 स्ट्रिंग स्टोर करें, जैसे +3725xxxxxxx, और सपोर्ट के लिए ज़रूरत हो तो यूज़र का कच्चा इनपुट अलग रखें।
कभी शून्य न जोड़ें; न कुछ हटाना है, न जोड़ना।
अपने इनपुट मास्क में सात और आठ अंकों, दोनों मोबाइल लंबाइयों को टेस्ट करें।

एस्टोनियाई यूज़र्स को भेजे जाने वाले सत्यापन टेक्स्ट आम तौर पर एस्टोनियाई में आते हैं, हालाँकि कई ऐप अकाउंट या डिवाइस की भाषा का पालन करते हैं, और रूसी या अंग्रेज़ी टेम्पलेट भी आम हैं। यदि आपका प्रोडक्ट एस्टोनियाई लोकेल देता है, तो जाँच लें कि õ, ä, ö और ü जैसे अक्षर टेम्पलेट से हैंडसेट तक सही-सलामत पहुँचते हैं।

टीमें एस्टोनियाई नंबरों पर साइन-अप फ़्लो क्यों टेस्ट करती हैं?

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

QA लीड +372 नंबर टेस्टिंग के लिए आम तौर पर इन कारणों से माँगता है:

यह पुष्टि करना कि छोटी नंबरिंग योजना वाले EU बाज़ार में कंट्री पिकर, फ़ोन मास्क और SMS टेम्पलेट ठीक व्यवहार करते हैं।
क्षेत्रीय रिलीज़ से पहले एस्टोनियाई कॉपी की लोकलाइज़ेशन जाँच।
किसी एस्टोनियाई ग्राहक के उस सपोर्ट टिकट को दोहराना जिसमें कोड नहीं पहुँचा था।

टीमें इन जाँचों को रिलीज़ चक्र में कैसे शामिल करती हैं, यह जानने के लिए QA टेस्टिंग देखें।

कोड कभी न दिखे तो मुझे क्या जाँचना चाहिए?

एक के बाद एक नंबर ऑर्डर करने के बजाय समस्या को क्रम से परखें:

अवधि पूरी चलने दें। एक्टिवेशन 20 मिनट खुला रहता है, और कुछ सेवाएँ अपने टेक्स्ट कतार में रखती हैं।
पुष्टि करें कि सेवा वर्चुअल नंबर लेती है। कुछ सेवाएँ नीति के तहत उन्हें अस्वीकार करती हैं; रिफ़ंड इसी कारण से है।
अंतिम स्थिति देखें। activation.expired इवेंट, या GET कॉल में expired स्थिति का मतलब है कि कोई SMS नहीं आया और पैसे पहले ही वॉलेट में लौट चुके हैं।
धैर्य के साथ दोबारा कोशिश करें। तेज़ लूप में दोबारा ऑर्डर करने के बजाय थोड़ी देर बाद फिर कोशिश करें, या उसी सेवा का कोई दूसरा रूट आज़माएँ।
अपना ट्रिगर जाँचें। जिस टेस्ट ने SMS माँगा ही नहीं, वह गायब कोड जैसा ही दिखता है।

हमारा लेख विफल OTP डिलीवरी घटाना और भी कारण बताता है जिन्हें जाँचना चाहिए।

क्या मैं एस्टोनियाई लाइन लंबे समय के लिए रख सकता हूँ, और बिलिंग कैसे चलती है?

एस्टोनिया का कोई सेल्फ़-सर्व लंबी अवधि वाला नंबर नहीं है। Dedicated Numbers अमेरिका और कनाडा का प्रोडक्ट हैं, $1.95/month से; Estonia के लिए, यदि आपकी टीम को स्थायी लाइन चाहिए तो [email protected] पर ईमेल करें, और टीम बताएगी कि स्थानीय नियम क्या अनुमति देते हैं, उपलब्धता का कोई वादा किए बिना।

OTP रूटिंग की बिलिंग एक प्रीपेड USD वॉलेट से चलती है, जिसमें न मासिक शुल्क है और न कोई प्लान चुनना है। कार्ड से या USDT अथवा USDC से टॉप-अप करें, और हर टॉप-अप पर ईमेल से PDF इनवॉइस आता है। मौजूदा दरें प्राइसिंग पेज पर हैं, और एंडपॉइंट रेफ़रेंस डॉक्स में है।

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

क्या मैं बिना लोकल SIM के अपने ऐप का एस्टोनियाई साइन-अप फ़्लो टेस्ट कर सकता हूँ?

हाँ। OTP Gateway से +372 नंबर ऑर्डर करें, उसे अपने साइन-अप फ़ॉर्म में इस्तेमाल करें और कोड डैशबोर्ड, वेबहुक या एक्टिवेशन एंडपॉइंट से पढ़ें।

OTP Route API में Estonia का कंट्री आईडी क्या है?

एक्टिवेशन और प्राइस अनुरोधों में country की वैल्यू के रूप में ee इस्तेमाल करें।

क्या एस्टोनियाई फ़ोन नंबरों में ट्रंक प्रीफ़िक्स होता है जिसे हटाना पड़े?

नहीं। एस्टोनिया में कोई ट्रंक प्रीफ़िक्स नहीं है, इसलिए घरेलू अंक +372 के बाद बिना बदलाव के जुड़ते हैं।

यदि एस्टोनिया का कोड न आए तो क्या मुझसे शुल्क लिया जाता है?

नहीं। यदि 20 मिनट की अवधि में कुछ नहीं आता, या आप पहले ही रद्द कर दें, तो पूरी राशि अपने-आप आपके वॉलेट में लौट जाती है।

क्या कोई नॉन-डेवलपर Estonia का सत्यापन नंबर ऑर्डर कर सकता है?

हाँ। डैशबोर्ड में Estonia और सेवा चुनें, दिखाई गई कीमत की पुष्टि करें, नंबर ऐप में कॉपी करें और उसी स्क्रीन पर कोड दिखने का इंतज़ार करें।

क्या असली राशि खर्च करने से पहले एस्टोनिया इंटीग्रेशन का अभ्यास किया जा सकता है?

सपोर्ट से अपने डेवलपमेंट अकाउंट को सैंडबॉक्स में बदलवाएँ, जो सिम्युलेटेड नंबर और कोड लौटाता है ताकि पूरा फ़्लो वॉलेट राशि के बिना चल सके।

इन नंबरों के इस्तेमाल पर कौन-से नियम लागू होते हैं?

हर सेवा की शर्तों और OTP Route की Acceptable Use Policy का पालन करें; ये नंबर आपके अपने वैध प्रोडक्ट और अकाउंट की टेस्टिंग व संचालन के लिए हैं।

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

एस्टोनिया में +372 सत्यापन कोड पाने से पहले की चेकलिस्ट