Sao Tome and Principe OTP API (+239) गाइड

प्रोडक्ट टीम Sao Tome and Principe में टेस्ट क्यों करेगी?

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

पुर्तगाली आधिकारिक भाषा है, और अंतरराष्ट्रीय ऐप के वेरिफिकेशन टेक्स्ट अकाउंट सेटिंग के हिसाब से अक्सर पुर्तगाली या अंग्रेज़ी में आते हैं। Forro जैसी स्थानीय क्रियोल भाषाएँ खूब बोली जाती हैं, पर ऑटोमेटेड SMS में शायद ही दिखती हैं।

व्यावहारिक कारण भी हैं। Sao Tome या Principe द्वीप पर स्टाफ़ रखने वाले NGO, विकास एजेंसियाँ और रिमोट-फ़र्स्ट नियोक्ता अक्सर पक्का करना चाहते हैं कि उनका ऑनबोर्डिंग स्थानीय नंबरों पर चलता है, और पुर्तगाल से रेमिटेंस कॉरिडोर बढ़ाने वाली फ़िनटेक टीमें सबूत चाहती हैं कि +239 ग्राहक रजिस्ट्रेशन पूरा कर सकता है। असली द्वीप नंबर के साथ QA रन यह सवाल किसी उलझे हुए यूज़र के सपोर्ट टिकट से तेज़ी से सुलझा देता है।

+239 नंबर कैसे लिखा और स्टोर किया जाता है?

राष्ट्रीय नंबर सात अंकों के होते हैं, और मोबाइल नंबर आम तौर पर 9 से शुरू होते हैं। E.164 में यह +239 और उसके बाद सात अंक बनता है। ऐसे छोटे नंबर उन वैलिडेटरों को चकमा देते हैं जो न्यूनतम आठ या ज़्यादा अंक मानकर चलते हैं, इसलिए अपने पार्सिंग टेस्ट में +239 का एक केस जोड़ें और स्टोर करने से पहले स्पेस या डैश हटाकर नॉर्मलाइज़ करें।

कुछ आदतें डेटा को साफ़ रखती हैं:

कैनोनिकल +239 स्ट्रिंग सेव करें और पहचाना गया देश अलग कॉलम में रखें।
किसी पुराने कॉन्टैक्ट कार्ड से पेस्ट हुआ 00239 इंटरनेशनल प्रीफ़िक्स हटा दें।
सात अंकों के नंबरों को निश्चित लंबाई वाले डेटाबेस फ़ील्ड में फ़िट करने के लिए पैड न करें; फ़ील्ड चौड़ा करें।
अपने यूनिट टेस्ट में कम से कम एक +239 फ़िक्स्चर रखें, ताकि वैलिडेटर में भविष्य का बदलाव उसे चुपचाप न तोड़ दे।

Sao Tome and Principe के लिए OTP Gateway क्या देता है?

इस देश की लाइव सूची में 600 से अधिक सर्विसें हैं। लोकप्रिय विकल्पों में WhatsApp, Telegram, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, Discord, LinkedIn, Signal, Viber, imo और Amazon शामिल हैं।

छोटे बाज़ार में कुछ घंटों पर कवरेज पतला पड़ सकता है। कल के नतीजों पर भरोसा करने की बजाय हर ऑर्डर से पहले GET /api/v1/prices पढ़ें, और अगर कोई रूट खाली हो तो उसकी तुलना किसी पास के लुसोफ़ोन रूट जैसे Cabo Verde या बड़े रूट जैसे Angola से करें।

कंट्री id st के लिए API फ़्लो कैसा दिखता है?

GET /api/v1/prices?country=st&service=<id> लाइव कीमत और उपलब्धता लौटाता है।
POST /api/v1/activations पर {"service": "<id>", "country": "st"} भेजने से एक नंबर रिज़र्व होता है।
नंबर को अपने ऐप में इस्तेमाल करें, फिर अपने webhook पर activation.sms_received का इंतज़ार करें या GET /api/v1/activations/{id} पोल करें।
POST /api/v1/activations/{id}/cancel उस कोशिश को ख़त्म करता है जिसकी अब ज़रूरत नहीं।

कॉल https://otproute.com/api/v1 पर Bearer or_live_ कुंजी के साथ जाते हैं। X-OTPRoute-Signature ("<t>.<raw body>" का HMAC-SHA256) जाँचें और पुराने टाइमस्टैम्प छोड़ दें; इसका तरीका HMAC से OTP webhook सुरक्षित करना में है।

क्या कोड न जानने वाला व्यक्ति भी इसे इस्तेमाल कर सकता है?

हाँ। ईमेल कोड या Google से साइन अप करने के बाद OTP Gateway खोलें, सर्विस चुनें, Sao Tome and Principe चुनें और लाइव कीमत की पुष्टि करें। नंबर तुरंत दिखता है, और SMS पहुँचते ही कोड उसी स्क्रीन पर आ जाता है।

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

लंबी अवधि का नंबर, बिलिंग और sandbox के बारे में क्या?

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

भुगतान एक प्रीपेड USD वॉलेट से होता है जिसमें कोई मासिक शुल्क नहीं है; इसे कार्ड या USDT/USDC से भरें, और हर टॉप-अप पर PDF इनवॉइस मिलता है। sandbox अकाउंट इंटीग्रेशन टेस्ट के लिए सिम्युलेटेड नंबर और कोड लौटाता है। ब्योरा /pricing पर है।

वॉलेट हर देश में साझा होता है, इसलिए पुर्तगाल या ब्राज़ील के साथ द्वीपों की टेस्टिंग करने वाली टीम वे सारे activation एक ही बैलेंस और एक ही सेट के इनवॉइस पर देखती है, जिससे महीने के अंत में फ़ाइनेंस के लिए हिसाब मिलाना आसान रहता है।

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

क्या मैं द्वीपों पर गए बिना अपने ऐप का Sao Tome and Principe साइन-अप जाँच सकता हूँ?

हाँ। OTP Route के OTP Gateway से +239 नंबर ऑर्डर करें, उसे अपने ऐप में डालें, और कोड डैशबोर्ड में या API से पढ़ें।

+239 कोड न आए तो क्या करूँ?

activation को पूरे 20 मिनट दें, फिर बाद में या किसी दूसरे सर्विस रूट से कोशिश करें। कुछ ही सेकंड में बार-बार दोबारा ऑर्डर करने से बचें।

क्या असफल Sao Tome and Principe activation का पैसा कटता है?

नहीं। अगर विंडो बंद होने से पहले SMS नहीं आता, या आप कैंसल कर देते हैं, तो पूरी रकम आपके वॉलेट में लौट जाती है।

कोई ऐप मेरा Sao Tome and Principe वेरिफिकेशन नंबर क्यों ठुकरा देता है?

कुछ सर्विसें वर्चुअल नंबर नहीं मानतीं। यह OTP Route के नियंत्रण से बाहर है, और इसीलिए अनुपयोगी activation का रिफ़ंड होता है।

क्या वेरिफिकेशन टेक्स्ट पुर्तगाली में होगा?

अक्सर, क्योंकि पुर्तगाली आधिकारिक भाषा है, लेकिन हर ऐप अपनी शब्दावली खुद चुनता है और अंग्रेज़ी भी इस्तेमाल कर सकता है।

क्या Sao Tome and Principe OTP API पर रेट लिमिट है?

हर अकाउंट 300 रिक्वेस्ट प्रति मिनट कर सकता है और 10 API कुंजियाँ तथा 5 webhook endpoints रख सकता है।

क्या मैं इसे CI जॉब में चला सकता हूँ?

हाँ, हर रन में एक activation ऑर्डर करके। टीमें इसे कैसे ढालती हैं, यह QA टेस्टिंग पेज में बताया गया है।

OTP Route किन उपयोगों की अनुमति देता है?

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

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

Sao Tome and Principe से +239 वेरिफिकेशन कोड कैसे पाएँ