हिन्दी
Qatar OTP API: webhook, पोलिंग और +974 टेस्ट नंबर
हाँ, OTP Route आपके सिस्टम तक Qatar (+974) के वेरिफिकेशन कोड पहुँचा सकता है: देश आईडी qa के साथ OTP Gateway से नंबर ऑर्डर करें, फिर कोड साइन किए गए webhook, API पोलिंग या डैशबोर्ड से लें। कीमत $0.20 प्रति कोड से शुरू होती है, और जिस ऑर्डर पर 20 मिनट में कोई SMS न आए उसकी पूरी रकम आपके वॉलेट में लौटा दी जाती है।
Qatar OTP API की कॉल-सीक्वेंस कैसी दिखती है?
सब कुछ https://otproute.com/api/v1 के अंतर्गत है, और प्रमाणीकरण or_live_ से शुरू होने वाली Bearer key से होता है। आप 10 keys तक रख सकते हैं, इसलिए CI, staging और ऑपरेशंस स्क्रिप्ट को अलग-अलग keys दें, ताकि एक को बाकी को छुए बिना रद्द किया जा सके। पूरा +974 एक्टिवेशन ज़्यादा से ज़्यादा चार कॉल लेता है:
GET /api/v1/prices?country=qa&service=<id>लाइव कीमत देता है और बताता है कि उस सर्विस के लिए रूट अभी खुला है।POST /api/v1/activationsको{"service": "<id>", "country": "qa"}के साथ भेजने पर क़तर का नंबर रिज़र्व होता है और एक्टिवेशन आईडी मिलती है।GET /api/v1/activations/{id}पोलिंग कॉल है: यह दिखाता है कि Qatar का ऑर्डर किस स्थिति में है, और डिलीवरी के बाद कोड भी देता है।POST /api/v1/activations/{id}/cancelऑर्डर को जल्दी खत्म करता है और रकम वॉलेट में लौटा देता है।
दो सहायक कॉल तस्वीर पूरी करती हैं: GET /api/v1/services नामों को सर्विस आईडी से जोड़ता है, और GET /api/v1/balance पाइपलाइन को खाली होने से पहले रोकने देता है। ट्रैफ़िक को प्रति अकाउंट 300 अनुरोध प्रति मिनट से नीचे रखें। developer ओवरव्यू में रेफ़रेंस पेज एक जगह मिलते हैं।
webhook हैंडलर को Qatar एक्टिवेशन इवेंट कैसे संभालने चाहिए?
पोलिंग चलती है, पर webhook से आपका टेस्ट रनर कुछ होते ही प्रतिक्रिया दे सकता है। पाँच endpoints तक रजिस्टर करें और activation.sms_received, activation.expired तथा activation.cancelled सब्सक्राइब करें; पहला कोड लाता है, और बाकी दो आपके रनर को इंतज़ार बंद करने को कहते हैं।
हर अनुरोध में X-OTPRoute-Signature होता है, t=<unix>,v1=<hex> के रूप में। साइन की गई स्ट्रिंग को टाइमस्टैम्प, एक बिंदु और raw रिक्वेस्ट बॉडी के रूप में दोबारा बनाएँ, endpoint के secret से HMAC-SHA256 निकालें और constant time में तुलना करें। पुराने टाइमस्टैम्प वाली कोई भी चीज़ ठुकरा दें। रीट्राई एक ही इवेंट को एक से ज़्यादा बार भेज सकते हैं, इसलिए एक्टिवेशन आईडी सेव करें और दोहराव को नज़रअंदाज़ करें। रेफ़रेंस इम्प्लीमेंटेशन के लिए webhook-based OTP capture पढ़ें।
कौन-सी सर्विसेज़ +974 नंबर पर कोड भेज सकती हैं?
Qatar सबसे व्यापक रूट में से एक है, जिसमें ताज़ा स्नैपशॉट पर 1,600 से अधिक सर्विसेज़ हैं। लोकप्रिय में WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude और Discord शामिल हैं।
इन्वेंटरी दिन भर बदलती है, इसलिए स्नैपशॉट को सिर्फ़ दिशा-सूचक और API के जवाब को सही मानें। कुछ सर्विसेज़ virtual नंबर ठुकरा देती हैं; ऐसा होने पर ऑर्डर बस एक्सपायर हो जाता है और पैसा लौट जाता है। ऊपर लिखा हर नाम अपने मालिक का ट्रेडमार्क है, और किसी संबद्धता का संकेत नहीं है।
टेस्ट फ़िक्स्चर में क़तरी नंबरों को नॉर्मलाइज़ करना
क़तरी नंबरों में +974 के बाद आठ अंक होते हैं और कोई ट्रंक प्रीफ़िक्स नहीं होता, इसलिए स्थानीय नंबर को अंतरराष्ट्रीय रूप में बदलते समय हटाने को कुछ नहीं है। फ़िक्स्चर E.164 (+974 और आठ अंक) में रखें, और यूज़र जो इनपुट 00974, स्पेस या किसी दूसरे देश की आदत से आए फ़ालतू शुरुआती शून्य के साथ लिखते हैं, उसे साफ़ करें।
अरबी आधिकारिक भाषा है, जबकि व्यापार में और प्रवासियों की बड़ी आबादी के बीच अंग्रेज़ी का खूब इस्तेमाल होता है। इसलिए वेरिफिकेशन टेक्स्ट उसी भाषा में आता है जो भेजने वाली सर्विस अकाउंट के लिए चुनती है, अक्सर अंग्रेज़ी या अरबी। देखें कि आपका एक्सट्रैक्शन लॉजिक दोनों लिपियों में कोड ढूँढ लेता है और अरबी UI में OTP इनपुट राइट-टू-लेफ़्ट लेआउट में भी इस्तेमाल के लायक रहता है।
टीमें Qatar रूट तब टेस्ट करती हैं जब वे GCC में लॉन्च कर रही हों, अरबी भाषियों के लिए कंज्यूमर ऐप का स्थानीयकरण कर रही हों, Doha में हॉस्पिटैलिटी या लॉजिस्टिक्स ऑपरेशंस चला रही हों, या किसी कर्मचारी का निजी नंबर लगाए बिना क्षेत्रीय बिज़नेस अकाउंट वेरिफाई कर रही हों। CI टेस्टिंग गाइड दिखाती है कि इन जाँचों को ऑटोमेटेड रन में कैसे जोड़ें।
इसके बजाय डैशबोर्ड से Qatar जाँच चलाना
हर वेरिफिकेशन के लिए स्क्रिप्ट ज़रूरी नहीं। डैशबोर्ड में OTP Gateway खोलें, Qatar और सर्विस चुनें, दिखाई गई कीमत देखें और पुष्टि करें। +974 नंबर को ऐप में कॉपी करें, SMS माँगें, और कोड ऑर्डर पर दिख जाता है। 20 मिनट की विंडो ऑर्डर देने के क्षण से गिनी जाती है, और पैसा तभी लगता है जब कोड आए।
कोड न आए तो: डीबगिंग की सूची
- क्या काफ़ी इंतज़ार किया? एक्टिवेशन को फ़ेल मानने से पहले उसकी पूरी विंडो चलने दें।
- क्या virtual नंबर स्वीकार हैं? कुछ सर्विसेज़ उन्हें ब्लॉक करती हैं, और बार-बार कोशिश से यह नहीं बदलेगा।
- क्या रीट्राई नीति ठीक है? बैकऑफ़ रखें और बाद में दोबारा कोशिश करें, या उसी सर्विस के लिए कोई दूसरा रूट चुनें। तेज़ लूप में दोबारा ऑर्डर करना रेट लिमिट बर्बाद करता है और शायद ही काम आता है।
- क्या हैंडलर ठीक है? अगर सिग्नेचर जाँच फ़ेल हो या endpoint एरर दे, तो
GET /api/v1/activations/{id}को पोल करके देखें कि कहीं कोड डिलीवर हो गया और आपका webhook उसे चूक गया।
जो एक्टिवेशन बिना SMS के खत्म होता है, चाहे एक्सपायर होकर या कैंसल होकर, उसकी पूरी रकम लौटा दी जाती है।
क्या क़तरी लंबी अवधि की लाइन मिलती है, और उपयोग का बिल कैसे बनता है?
Qatar के लिए कोई self-serve लंबी अवधि का नंबर नहीं है। Dedicated Virtual Numbers (आपकी अपनी लाइन, जिसमें इनबाउंड और आउटबाउंड SMS, webhook फ़ॉरवर्डिंग और ब्राउज़र कॉलिंग है) सिर्फ़ United States और Canada में मिलते हैं, $1.95/महीने से। Qatar की किसी खास ज़रूरत के लिए [email protected] पर ईमेल करें; क्या संभव है, यह स्थानीय नियम तय करते हैं।
Qatar का उपयोग एक प्रीपेड USD वॉलेट से कटता है, और कुछ भी मासिक बिल नहीं होता। कार्ड या USDT/USDC से टॉप-अप करें, हर टॉप-अप का PDF इनवॉइस लें, और अगर इंटीग्रेशन को सिमुलेटेड नंबरों से टेस्ट करना हो तो डेवलपमेंट अकाउंट पर sandbox मोड माँगें। +974 नंबरों का इस्तेमाल सिर्फ़ अपने प्रोडक्ट्स और वैध बिज़नेस अकाउंट के लिए करें, हर सर्विस की शर्तों का सम्मान करें, और OTP Route की Acceptable Use Policy का पालन करें।
अक्सर पूछे जाने वाले प्रश्न
ऑटोमेटेड टेस्ट में Qatar SMS OTP कोड कैसे पाऊँ?
देश qa के साथ एक्टिवेशन बनाएँ, लौटाया गया नंबर टेस्ट किए जा रहे ऐप में डालें, और activation.sms_received webhook का इंतज़ार करें। अगर आपका टेस्ट रनर इनबाउंड अनुरोध नहीं ले सकता, तो OTP Route एक्टिवेशन की पोलिंग भी सपोर्ट करता है।
क्या मैं क़तरी सिम के बिना +974 नंबर से टेस्ट कर सकता हूँ?
हाँ। OTP Gateway एक कोड के लिए Qatar वेरिफिकेशन नंबर देता है, इसलिए आप किसी स्थानीय सिम या डिवाइस के बिना साइन-अप या लॉगिन फ़्लो टेस्ट कर सकते हैं।
ऑर्डर से पहले Qatar की कीमतें कैसे देखूँ?
GET /api/v1/prices?country=qa&service=<id> कॉल करें या डैशबोर्ड देखें। दरें $0.20 प्रति कोड से शुरू होती हैं और सर्विस के हिसाब से बदलती हैं।
क्या फ़ेल हुए Qatar एक्टिवेशन का पैसा कटता है?
नहीं। बिल तभी बनता है जब कोड आए; एक्सपायर या कैंसल हुए एक्टिवेशन की रकम अपने आप वॉलेट में लौट जाती है।
पड़ोसी देश के बजाय क़तरी नंबर से ही टेस्ट क्यों करें?
वही देश चुनें जो अकाउंट के असली बाज़ार से मेल खाता हो। अगर आपका प्रोडक्ट Qatar में लॉन्च हो रहा है, तो +974 नंबर ठीक वही कंट्री-कोड हैंडलिंग, भाषा और OTP routing परखता है जो आपके ग्राहक देखेंगे, जैसा country routing for OTP में बताया गया है।
क्या डेवलपमेंट अकाउंट वॉलेट में पैसे के बिना चल सकता है?
हाँ। अनुरोध पर डेवलपमेंट अकाउंट को sandbox में बदला जा सकता है, जो एंड-टू-एंड टेस्टिंग के लिए सिमुलेटेड नंबर और कोड लौटाता है।
क्या मैं बार-बार लॉगिन के लिए क़तरी नंबर रख सकता हूँ?
self-serve आधार पर नहीं, क्योंकि डेडिकेटेड लाइनें US और Canada तक सीमित हैं। Qatar की लंबी अवधि की लाइन के बारे में पूछना हो तो [email protected] पर ईमेल करें।
सेवाओं के नाम उनके संबंधित स्वामियों के ट्रेडमार्क हैं। OTP Route का उनसे कोई संबंध नहीं है। नंबरों का उपयोग कानूनी रूप से करें तथा प्रत्येक सेवा की शर्तों और हमारी स्वीकार्य उपयोग नीति का पालन करें।