जापान OTP API: QA के लिए +81 वेरिफ़िकेशन नंबर

Q: API कॉल में जापान के लिए मैं कौन-सा country id भेजूँ?

activation बॉडी और prices क्वेरी, दोनों में jp इस्तेमाल करें।

Q: क्या 090 नंबर शुरुआती शून्य के साथ स्टोर करने चाहिए?

नहीं। ट्रंक शून्य के बिना +81 के बाद नंबर स्टोर करें, उदाहरण के लिए +81 90 और बाक़ी आठ अंक।

जापानी लॉन्च फ़ोन-नंबर वाले स्टेप पर क्यों अटक जाता है?

जापानी रिलीज़ की तैयारी करने वाली टीमों के पास आम तौर पर अनुवाद तैयार होता है, भुगतान के तरीक़े जुड़े होते हैं और App Store लिस्टिंग का ड्राफ़्ट बन चुका होता है। फिर कोई पूछता है कि असली +81 नंबर से साइन-अप फ़्लो कौन वेरिफ़ाई करेगा, और कमरे में सन्नाटा छा जाता है।

यह कमी कुछ अनुमानित जगहों पर दिखती है:

लोकलाइज़ेशन QA को पक्का करना होता है कि फ़ोन फ़ील्ड वही फ़ॉर्मैट स्वीकार करे जो जापानी यूज़र असल में टाइप करते हैं, जिनमें हाइफ़न के साथ लिखे नंबर भी शामिल हैं।
क्षेत्रीय संचालन स्टाफ़ को टोक्यो या ओसाका में डिवाइस बदलने के बाद साझा बिज़नेस अकाउंट रिकवर करना होता है, और कोई उस पर निजी नंबर नहीं डालना चाहता।
जापानी प्लेटफ़ॉर्म के साथ पार्टनर और इंटीग्रेशन में बिज़नेस प्रोफ़ाइल ऑनबोर्ड करते समय कभी-कभी स्थानीय नंबर माँगा जाता है।

OTP Gateway भौतिक SIM पर निर्भरता ख़त्म कर देता है। यह एक वेरिफ़िकेशन के लिए +81 नंबर देता है, हमारे कैरियर पार्टनर्स पर OTP routing के ज़रिए SMS जुटाता है, और नतीजा आपके कोड या ब्राउज़र को सौंप देता है।

टेस्टिंग के लिए +81 नंबर पर मैं क्या वेरिफ़ाई कर सकता हूँ?

जापान का वेरिफ़िकेशन नंबर अभी 1,500 से ज़्यादा सेवाओं के लिए ऑर्डर किया जा सकता है। लाइव स्नैपशॉट में लोकप्रिय रूटों में LINE, X (Twitter), Amazon, Netflix, Google (Gmail & YouTube), Instagram, TikTok, Discord, Uber, Airbnb, Microsoft & Outlook, ChatGPT (OpenAI), Facebook और WhatsApp शामिल हैं।

LINE का ख़ास ज़िक्र ज़रूरी है, क्योंकि जापान में बड़ी संख्या में लोगों के लिए यही डिफ़ॉल्ट मैसेजिंग ऐप है; इसलिए जो प्रोडक्ट LINE लॉगिन या LINE नोटिफ़िकेशन देता है, उसे सादे SMS के साथ वह रास्ता भी कवर करना चाहिए। उपलब्धता दिन के दौरान बदलती रहती है, इसीलिए आपके टूलिंग की सूची इस पेज से नहीं, API से आनी चाहिए।

जापान OTP API को टेस्ट रनर में कैसे जोड़ूँ?

SMS वेरिफ़िकेशन API https://otproute.com/api/v1 पर है। Developer console में कुंजी बनाएँ (वे or_live_ से शुरू होती हैं), उसे Bearer टोकन की तरह भेजें, और 300 अनुरोध प्रति मिनट के भीतर रहें। एक अकाउंट में 10 कुंजियाँ और 5 webhook endpoint हो सकते हैं।

एक सामान्य रन ऐसा दिखता है:

GET /api/v1/services और GET /api/v1/countries से id एक बार निकालें; जापान jp है।
GET /api/v1/prices?country=jp&service=<id> से मौजूदा दर लाएँ और उसे टेस्ट नतीजे के साथ सेव करें।
POST /api/v1/activations और बॉडी {"service": "<id>", "country": "jp"} से ऑर्डर बनाएँ।
लौटाया गया नंबर टेस्ट वाले ऐप में डालें और SMS ट्रिगर करें।
अपने webhook पर activation.sms_received पाएँ, या अगर रनर फ़ायरवॉल के पीछे है तो GET /api/v1/activations/{id} को poll करें।
टियरडाउन में, जिस भी activation की टेस्ट को अब ज़रूरत नहीं, उसके लिए POST /api/v1/activations/{id}/cancel कॉल करें।

Webhook अनुरोधों में X-OTPRoute-Signature: t=<unix>,v1=<hex> होता है। endpoint secret से <t>.<raw body> पर HMAC-SHA256 दोबारा निकालें, सुरक्षित तरीक़े से तुलना करें, और पुराने टाइमस्टैम्प ठुकरा दें। इवेंट्स को activation id पर आधारित मानें, ताकि रीट्राई बेअसर रहे। CI के ब्योरे के लिए CI पाइपलाइन में SMS OTP टेस्टिंग और QA टेस्टिंग समाधान देखें।

क्या टोक्यो ऑफ़िस में कोई नॉन-डेवलपर ब्राउज़र से यह कर सकता है?

हाँ। OTP Route डैशबोर्ड में OTP Gateway खोलें, जापान और सेवा चुनें, दिखाई गई क़ीमत जाँचें और कन्फ़र्म करें। नंबर तुरंत दिख जाता है; संदेश आते ही कोड उसके बगल में दिखता है। कुछ इंस्टॉल नहीं करना पड़ता, इसलिए किसी सपोर्ट लीड या मार्केटिंग मैनेजर के लिए कैंपेन लैंडिंग फ़्लो जाँचना व्यावहारिक रहता है।

जापानी मोबाइल नंबर का फ़ॉर्मैट कैसा होता है, और संदेश कैसे दिखते हैं?

जापान में घरेलू ट्रंक प्रिफ़िक्स 0 है। मोबाइल नंबर आम तौर पर 070, 080 या 090 और उसके बाद आठ अंकों के रूप में लिखे जाते हैं, अक्सर हाइफ़न से बँटे हुए। E.164 में शून्य हट जाता है, इसलिए 090 और बाक़ी अंक +81 90 और आठ अंक बन जाते हैं। सिर्फ़ E.164 रूप सेव करें, यूज़र के टाइप किए हाइफ़न और स्पेस हटा दें, और पक्का करें कि आपका वैलिडेटर 070 रेंज को reject न करे।

वेरिफ़िकेशन संदेश अक्सर जापानी में आते हैं, जिसमें कांजी, हिरागाना और काताकाना मिले होते हैं, और कुछ में सामान्य ASCII अंकों की जगह फ़ुल-विड्थ अंक होते हैं। कोड निकालने से पहले टेक्स्ट को Unicode NFKC नॉर्मलाइज़ेशन से गुज़ारें, वरना [0-9] वाला regex उसे चुपचाप चूक सकता है। जापानी टेक्स्ट का मतलब यह भी है कि SMS Unicode एन्कोडिंग में जाता है, इसलिए लॉग UTF-8 में रखें ताकि नाकामियाँ बाद में पढ़ सकें।

कोड नहीं दिखा। हमें क्या आज़माना चाहिए?

न पहुँचने का मतलब कोई शुल्क नहीं: 20 मिनट SMS के बिना बीत जाएँ, या आप कैंसल कर दें, तो पूरी रक़म अपने-आप वॉलेट में रिफ़ंड हो जाती है। दोबारा ऑर्डर करने से पहले:

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

रूट अलग क्यों होते हैं, यह OTP के लिए कंट्री रूटिंग वाला लेख समझाता है।

क्या जापान की लंबे समय वाली लाइन है, और वॉलेट की बिलिंग कैसे होती है?

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

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

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

क्या मैं जापानी SIM कार्ड के बिना जापान के SMS OTP कोड पा सकता हूँ?

हाँ। OTP Gateway एक वेरिफ़िकेशन के लिए +81 नंबर देता है और कोड डैशबोर्ड में दिखाता है या आपके webhook को भेजता है।

API कॉल में जापान के लिए मैं कौन-सा country id भेजूँ?

activation बॉडी और prices क्वेरी, दोनों में jp इस्तेमाल करें।

मेरा पार्सर जापानी संदेशों के कोड क्यों चूक जाता है?

संदेश में फ़ुल-विड्थ अंक हो सकते हैं। मैच करने से पहले NFKC नॉर्मलाइज़ेशन लगाएँ, तब कोड सामान्य अंक वाले पैटर्न से मैच हो जाएगा।

क्या 090 नंबर शुरुआती शून्य के साथ स्टोर करने चाहिए?

नहीं। ट्रंक शून्य के बिना +81 के बाद नंबर स्टोर करें, उदाहरण के लिए +81 90 और बाक़ी आठ अंक।

अगर जापानी वेरिफ़िकेशन कोड न आए तो मेरे पैसे का क्या होता है?

20 मिनट की विंडो ख़त्म होते ही, या आपके activation कैंसल करते ही, वह अपने-आप आपके वॉलेट में लौट जाता है।

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

LINE जापान के लिए उपलब्ध सेवाओं में दिखता है, हालाँकि उपलब्धता बदलती रहती है। लाइव सूची देखें, और जो भी अकाउंट बनाएँ उसके लिए LINE की शर्तों का पालन करें।

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

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

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

जापानी फ़ोन के बिना जापान में शिप करना: +81 कोड की टेस्टिंग