पुर्तगाल में लॉन्च के लिए प्रोग्रामैटिक +351 वेरिफिकेशन कोड

+351 वेरिफिकेशन रन में कौन-से एंडपॉइंट इस्तेमाल होते हैं?

बेस URL https://otproute.com/api/v1 है, और हर अनुरोध के साथ or_live_ से शुरू होने वाली Bearer key जाती है। Portugal की देश आईडी pt है।

1. GET /api/v1/countries और GET /api/v1/services से आईडी मिलती हैं; हर टेस्ट रन के लिए इन्हें कैश कर लें।
2. GET /api/v1/prices?country=pt&service=<id> मौजूदा कीमत बताता है और यह भी कि रूट खुला है या नहीं।
3. POST /api/v1/activations को {"service": "telegram", "country": "pt"} के साथ भेजने पर नंबर रिज़र्व होता है और एक्टिवेशन आईडी मिलती है।
4. अगर आप पोलिंग पसंद करते हैं, तो GET /api/v1/activations/{id} स्टेटस और कोड बताता है।
5. POST /api/v1/activations/{id}/cancel उस नंबर को छोड़ देता है जिसकी आपके टेस्ट को अब ज़रूरत नहीं।
6. GET /api/v1/balance से पाइपलाइन वॉलेट कम होने पर पहले ही रुक सकती है।

अकाउंट की सीमाएँ हैं: 10 API keys, 5 webhook endpoints और 300 अनुरोध प्रति मिनट। पूरे स्कीमा API रेफ़रेंस में हैं।

साइन किए गए webhook पुर्तगाली कोड हमारी सर्विस तक कैसे पहुँचाते हैं?

Developer console में एक HTTPS endpoint रजिस्टर करें और activation.sms_received, activation.expired तथा activation.cancelled को सब्सक्राइब करें। हर POST में X-OTPRoute-Signature: t=<unix>,v1=<hex> शामिल होता है।

इसे जाँचने के लिए <t>.<raw body> स्ट्रिंग दोबारा बनाएँ, endpoint के secret से HMAC-SHA256 निकालें और v1 से constant-time तुलना करें। जिन अनुरोधों का टाइमस्टैम्प बहुत पुराना हो उन्हें ठुकरा दें, ताकि पकड़ा गया अनुरोध दोबारा न चलाया जा सके। हर इवेंट की एक्टिवेशन आईडी सेव रखें और दोहराए गए इवेंट को नज़रअंदाज़ करें; इससे डिलीवरी रीट्राई होने पर भी हैंडलर सुरक्षित रहता है। यह पैटर्न webhook-based OTP capture में कदम-दर-कदम समझाया गया है।

पुर्तगाली रूट पर कौन-सी सर्विसेज़ खुली हैं?

मौजूदा स्नैपशॉट में Portugal के लिए 2,000 से अधिक सर्विसेज़ दिखती हैं। अक्सर इस्तेमाल होने वालों में WhatsApp, Telegram, Airbnb, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Netflix, Discord और Signal शामिल हैं।

हमारे कैरियर पार्टनर दिन भर क्षमता घटाते-बढ़ाते रहते हैं, इसलिए यह सूची बदलती रहती है। यही कारण है कि कोई टेस्ट चलेगा या नहीं, यह किसी स्थिर कॉन्फ़िग फ़ाइल से नहीं, बल्कि prices endpoint से तय होना चाहिए।

प्रोडक्ट टीमें पुर्तगाली नंबरों पर टेस्ट क्यों करती हैं?

यूरोप में रोलआउट की योजना में Portugal अक्सर शुरुआती देशों में आता है। Lisbon और Porto में कई प्रोडक्ट और इंजीनियरिंग टीमें हैं, और बहुत सी कंपनियाँ Portugal को अपना यूरोपीय आधार बनाती हैं। स्थानीयकरण की भी एक वजह है: यूरोपीय पुर्तगाली (pt-PT) वर्तनी, शब्दावली और संबोधन के तरीकों में ब्राज़ीलियन पुर्तगाली से अलग है, इसलिए ब्राज़ील के लिए अनुवादित फ़्लो Portugal के किसी यूज़र को अटपटा लग सकता है। असली +351 वेरिफिकेशन चलाने पर समीक्षक pt-PT कॉपी, आने वाला SMS और आसपास की स्क्रीन, तीनों एक साथ देख पाते हैं।

GDPR के तहत, स्टाफ़ के फ़ोन नंबर टेस्ट और साझा अकाउंट से दूर रखना डेटा-न्यूनतमीकरण के लिहाज़ से भी अच्छा है। हर जाँच के लिए एक बार वाला नंबर होने का मतलब है आपके QA सिस्टम में कम निजी पहचान-चिह्न। CI पाइपलाइन गाइड दिखाती है कि इसे हर बिल्ड का हिस्सा कैसे बनाएँ।

+351 नंबर किस फ़ॉर्मेट में लिखे और सेव किए जाते हैं?

Portugal में कोई ट्रंक प्रीफ़िक्स नहीं है: नंबर नौ अंकों के होते हैं और घरेलू व अंतरराष्ट्रीय दोनों रूप में +351 के बाद वैसे ही डायल किए जाते हैं। मोबाइल नंबर 9 से शुरू होते हैं, जबकि भौगोलिक लैंडलाइन 2 से। इन्हें E.164 में सेव करें, कंट्री कोड के बाद नौ अंकों से अलग कुछ भी हो तो अस्वीकार करें, और यूज़र तीन-तीन अंकों के समूह बनाकर जो स्पेस डालते हैं उन्हें हटा दें।

आने वाले कोड आम तौर पर पुर्तगाली या अंग्रेज़ी में आते हैं, जो भेजने वाली सर्विस और अकाउंट की भाषा पर निर्भर करता है। आपका कोड एक्सट्रैक्टर किसी तय वाक्यांश के बजाय अंकों को खोजे।

क्या कोई साथी बिना कोड के यह कर सकता है, और SMS न आए तो क्या करें?

डैशबोर्ड में OTP Gateway खोलें, Portugal और एक सर्विस चुनें, लाइव कीमत देखें और ऑर्डर करें। नंबर को अपने ऐप में डालें और कोड के लिए एक्टिवेशन पेज पर इंतज़ार करें।

विंडो 20 मिनट की होती है, और पैसा तभी लगता है जब कोड आए; वरना पूरी रकम अपने आप वॉलेट में लौट जाती है। कोड न आने पर:

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

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

OTP Route Portugal में self-serve डेडिकेटेड नंबर नहीं बेचता। Dedicated Virtual Numbers सिर्फ़ United States और Canada के लिए हैं, $1.95/महीने से; लंबे समय की +351 लाइन के लिए [email protected] पर ईमेल करें, पर यह ध्यान रखें कि उपलब्धता स्थानीय नियमों पर निर्भर है और तय नहीं है। अस्थायी और डेडिकेटेड नंबरों में अंतर देखें।

भुगतान प्रीपेड USD वॉलेट से pay as you go होता है, बिना मासिक शुल्क या प्लान के; टॉप-अप कार्ड या USDT/USDC से होता है और हर टॉप-अप के साथ PDF इनवॉइस मिलता है। डेवलपमेंट अकाउंट को अनुरोध पर sandbox में बदला जा सकता है, ताकि सिमुलेटेड नंबरों और कोड से टेस्ट हो सके। हर सर्विस की शर्तों का पालन करें; OTP Route की Acceptable Use Policy लागू होती है।

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

OTP Route API के लिए Portugal की देश आईडी क्या है?

यह pt है, जिसे prices क्वेरी और activation अनुरोध की बॉडी, दोनों में इस्तेमाल किया जाता है।

क्या पुर्तगाली फ़ोन नंबरों में शुरुआती 0 जैसा ट्रंक प्रीफ़िक्स होता है?

नहीं। पुर्तगाली नंबर नौ अंकों के होते हैं और उनमें कोई ट्रंक प्रीफ़िक्स नहीं होता, इसलिए E.164 रूप +351 और उसके बाद वे नौ अंक हैं।

क्या मैं पुर्तगाली सिम कार्ड के बिना pt-PT ऑनबोर्डिंग फ़्लो टेस्ट कर सकता हूँ?

हाँ। OTP Gateway से टेस्टिंग के लिए मिला +351 नंबर कोड प्राप्त करता है, जिसे आप डैशबोर्ड में या API के ज़रिये पढ़ सकते हैं।

Portugal वेरिफिकेशन नंबर की कीमत क्या है?

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

क्या कुछ न मिलने वाले +351 एक्टिवेशन के लिए मुझे भुगतान करना पड़ेगा?

नहीं। एक्सपायर या कैंसल हुए एक्टिवेशन की पूरी रकम आपके वॉलेट में लौट जाती है।

क्या मैं लगातार लॉगिन के लिए पुर्तगाली नंबर किराए पर ले सकता हूँ?

self-serve रूप में नहीं। लंबे समय की लाइनें US और Canada का प्रोडक्ट हैं; +351 लाइन चाहिए तो सपोर्ट को ईमेल करें।

पुर्तगाली कोड के लिए मुझे पोलिंग करनी चाहिए या webhook?

पैरेलल जॉब्स के लिए webhook बेहतर स्केल करते हैं, जबकि जिन रनर्स पर इनबाउंड ट्रैफ़िक नहीं आ सकता, उनके लिए GET /api/v1/activations/{id} की पोलिंग ठीक रहती है।

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