हिन्दी
काबो वेर्दे (+238) के वेरिफिकेशन कोड अपने टेस्ट स्टैक में खींचना
OTP Gateway से एक बार वाला नंबर मँगाकर और कोड को REST API, साइन किए गए वेबहुक या डैशबोर्ड से पढ़कर आप OTP Route के साथ काबो वेर्दे (+238) के SMS वेरिफिकेशन कोड पा सकते हैं। कीमत $0.20 प्रति कोड से शुरू होती है, हर सर्विस की लाइव कीमत GET /api/v1/prices से मिलती है, और 20 मिनट की विंडो में कुछ न आए तो वॉलेट में पूरी रकम लौट जाती है।
+238 activation में कौन-से endpoints इस्तेमाल होते हैं?
काबो वेर्दे OTP API इंटीग्रेशन के लिए https://otproute.com/api/v1 के अंतर्गत कॉल की बस एक छोटी सूची चाहिए। हर रिक्वेस्ट के साथ or_live_ से शुरू होने वाली Bearer key जाती है, जो Developer console में बनती है। काबो वेर्दे की country id cv है; सर्विस id उस ऐप का api_service मान है जिसे आप टेस्ट कर रहे हैं।
GET /api/v1/servicesऔरGET /api/v1/countriesकैटलॉग लाते हैं; उन्हें दिन भर के लिए कैश करें।GET /api/v1/prices?country=cv&service=<id>मौजूदा कीमत पढ़ता है और बताता है कि रूट अभी खुला है या नहीं। इन्वेंटरी दिन भर बदलती है, इसलिए कुछ भी हार्ड-कोड करने के बजाय हर ऑर्डर से पहले इसे क्वेरी करें।{"service": "whatsapp", "country": "cv"}के साथPOST /api/v1/activationsएक activation id और वह +238 नंबर लौटाता है जिसे आपको अपने साइन-अप फ़ॉर्म में टाइप करना है।- अगर आप वेबहुक इस्तेमाल नहीं कर रहे, तो
GET /api/v1/activations/{id}से कोड के लिए पोल किया जा सकता है। - टेस्ट बीच में रुक जाए तो
POST /api/v1/activations/{id}/cancelनंबर छोड़ देता है, और होल्ड की गई रकम वॉलेट में लौट जाती है।
रन से पहले GET /api/v1/balance कॉल करने से सूट बीच में फेल होने के बजाय पहले ही रुक सकता है। सीमा 300 रिक्वेस्ट प्रति मिनट प्रति अकाउंट है, और API reference में हर फ़ील्ड की सूची है।
काबो वेर्दे कोड के लिए साइन किया हुआ वेबहुक कैसे स्वीकार करूँ?
पोलिंग एक अकेली स्क्रिप्ट के लिए ठीक है; कई जॉब समानांतर चलने लगें तो वेबहुक ज़्यादा सलीकेदार रहता है। Developer console में एक endpoint रजिस्टर करें (एक अकाउंट में पाँच रखे जा सकते हैं) और activation.sms_received, activation.expired तथा activation.cancelled के लिए सब्सक्राइब करें।
हर POST के साथ t=<unix>,v1=<hex> रूप वाला X-OTPRoute-Signature हेडर आता है। स्ट्रिंग <t>.<raw body> दोबारा बनाएँ, उसे उस endpoint के secret से HMAC-SHA256 से साइन करें, और नतीजे का v1 से constant-time जाँच द्वारा मिलान करें। जिसका टाइमस्टैम्प कुछ मिनट से पुराना हो उसे छोड़ दें ताकि पकड़ी गई रिक्वेस्ट दोबारा न चलाई जा सके। उसके बाद अपनी प्रोसेसिंग activation id पर आधारित रखें: अगर वही इवेंट दो बार आए, तो दूसरी प्रति से कुछ नहीं बदलना चाहिए। किनारे के मामले हमारे लेख OTP वेबहुक को HMAC से सुरक्षित करना में हैं।
आज कौन-से ऐप केप वेर्दे के नंबर पर कोड भेज सकते हैं?
cv का लाइव कैटलॉग 800 से अधिक सर्विस कवर करता है। इस समय खुली लोकप्रिय सर्विस में WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Viber, Telegram और Netflix शामिल हैं। उस सूची को स्नैपशॉट की तरह पढ़ें: पार्टनर की क्षमता के साथ रूट खुलते और बंद होते हैं, और OTP रूटिंग का मतलब यही है कि वादा करने वाले पेज के बजाय ऐसी API से काम लिया जाए जो उपलब्धता रियल टाइम में बताती है।
अगर टीम में कोई कोड नहीं लिखता, तो डैशबोर्ड वही काम कर देता है। सर्विस चुनें, काबो वेर्दे चुनें, स्क्रीन पर कीमत की पुष्टि करें और नंबर कॉपी करें। कोड आते ही वह activation कार्ड पर दिखने लगता है।
स्टोर करते समय +238 नंबर कैसा दिखता है?
काबो वेर्दे में बंद नंबरिंग प्लान है: सात अंकों के राष्ट्रीय नंबर और कोई trunk प्रीफ़िक्स नहीं, इसलिए हटाने लायक कोई शुरुआती शून्य नहीं है। E.164 में नंबर बस +238 और उसके बाद वे सात अंक हैं। इसलिए नॉर्मलाइज़ेशन आसान है, फिर भी छोटी लंबाई उन वैलिडेटरों को अटका देती है जो मानते हैं कि हर सब्सक्राइबर नंबर इससे लंबा होता है; यही वजह है कि कोई फ़ॉर्म एकदम वैध केप वेर्दे एंट्री को रिजेक्ट कर देता है। E.164 स्ट्रिंग स्टोर करें, उसे अपने UI की पसंद के अनुसार फ़ॉर्मैट करें, और अपने फ़ोन-फ़ील्ड यूनिट टेस्ट में +238 का एक केस जोड़ें।
पुर्तगाली आधिकारिक भाषा है, जबकि रोज़मर्रा में ज़्यादातर लोग केप वेर्दियन क्रियोलू बोलते हैं, इसलिए देखें कि वहाँ के हैंडसेट पर पुर्तगाली OTP टेम्पलेट कैसा दिखता है। टीमें आम तौर पर प्रवासी समुदाय की वजह से +238 नंबर लेती हैं: अमेरिका, पुर्तगाल और यूरोप के अन्य हिस्सों में बसे केप वेर्दियन समुदाय अपने अकाउंट घर के नंबरों से जोड़े रखते हैं, और रेमिटेंस, यात्रा और मैसेजिंग प्रोडक्ट चाहते हैं कि वे साइन-अप ठीक से चलें।
20 मिनट में कोई SMS न आए तो वॉलेट का क्या होता है?
हर activation 20 मिनट खुला रहता है। उस विंडो में कोड आ जाए तो शुल्क लगा रहता है; विंडो खाली बंद हो जाए, या आप पहले कैंसल कर दें, तो पूरी रकम बिना किसी सपोर्ट टिकट के आपके वॉलेट में लौट आती है। कुछ न आए तो:
- हर कुछ सेकंड में नया ऑर्डर देने के बजाय विंडो अपना समय पूरा करने दें; तेज़ रिट्राई लूप सिर्फ़ फ़ंड रोक देता है।
- बाद में फिर कोशिश करें, या वही फ़्लो किसी दूसरी सर्विस रूट से चलाकर देखें।
- पुष्टि करें कि ऐप वर्चुअल नंबर स्वीकार करता भी है या नहीं; कुछ नीति के तहत उन्हें नकार देते हैं, और रिफ़ंड ठीक इसी स्थिति के लिए है।
- जाँचें कि आपके फ़ॉर्म ने पूरा +238 नंबर सबमिट किया, कटा हुआ नहीं।
निदान पर और गहराई के लिए OTP डिलीवरी फेल होने को कम करना गाइड देखें।
क्या बार-बार लॉगिन के लिए मैं काबो वेर्दे का नंबर रख सकता हूँ?
सेल्फ़-सर्व आधार पर नहीं। OTP Route के Dedicated Numbers, यानी इनबाउंड और आउटबाउंड SMS, ब्राउज़र कॉलिंग और वेबहुक फ़ॉरवर्डिंग वाली लंबी अवधि की लाइनें, संयुक्त राज्य अमेरिका और कनाडा का प्रोडक्ट हैं, $1.95/month से शुरू। +238 की कोई सेल्फ़-सर्व लंबी अवधि वाली लाइन नहीं है। अगर आपकी टीम को सचमुच ज़रूरत है, तो [email protected] पर ईमेल करें; वह हो पाएगा या नहीं, यह स्थानीय नियमों पर निर्भर है और उसकी गारंटी नहीं है। ऐसे staging अकाउंट के लिए जिसमें बार-बार साइन इन करना पड़ता है, अमेरिका या कनाडा का virtual number अक्सर व्यावहारिक जवाब होता है।
उपयोग का बिल कैसे बनता है, और लाइव जाने से पहले टेस्टिंग कैसे हो?
बिलिंग एक ही प्रीपेड USD वॉलेट से चलती है, न कोई मासिक शुल्क और न प्लान टियर। कार्ड या USDT/USDC स्टेबलकॉइन से टॉप-अप करें; हर टॉप-अप के साथ ईमेल पर PDF इनवॉइस आता है, जिससे फ़ाइनेंस का मिलान सरल रहता है। प्रोडक्शन keys वॉलेट को छुएँ, इससे पहले अपने डेवलपमेंट अकाउंट को sandbox पर स्विच करने को कहें: वह सिम्युलेटेड नंबर और कोड लौटाता है, इसलिए आपके SMS वेरिफिकेशन API क्लाइंट का ऑर्डर, वेबहुक और कैंसल पाथ बिना कुछ खर्च किए CI में चल सकता है। pricing और QA टेस्टिंग का अवलोकन देखें। पूरे समय हर सर्विस की शर्तों और OTP Route की Acceptable Use Policy का पालन करें।
अक्सर पूछे जाने वाले प्रश्न
क्या मैं लोकल SIM के बिना अपने ऐप का काबो वेर्दे साइन-अप फ़्लो टेस्ट कर सकता हूँ?
हाँ। OTP Gateway से +238 नंबर ऑर्डर करें, उसे अपने साइन-अप फ़ॉर्म में डालें और कोड डैशबोर्ड, API या वेबहुक से पढ़ें। टीम में किसी को द्वीपों पर होने की ज़रूरत नहीं।
OTP Route API में काबो वेर्दे की country id क्या है?
वह cv है। उसे POST /api/v1/activations में और prices क्वेरी में country के रूप में दें।
क्या केप वेर्दे के नंबर से पहले 0 जोड़ना पड़ता है?
नहीं। काबो वेर्दे में कोई trunk प्रीफ़िक्स नहीं है, इसलिए अंतरराष्ट्रीय रूप बस +238 और सात अंकों का राष्ट्रीय नंबर है।
काबो वेर्दे वेरिफिकेशन नंबर की कीमत कितनी है?
OTP Gateway की कीमत $0.20 प्रति कोड से शुरू होती है और सर्विस के हिसाब से बदलती है; API और डैशबोर्ड ऑर्डर से पहले सटीक कीमत दिखाते हैं। शुल्क तभी लगता है जब कोड आ जाए।
क्या हर ऐप केप वेर्दे के वर्चुअल नंबर पर कोड भेजेगा?
नहीं। कुछ सर्विस वर्चुअल नंबर नकार देती हैं, और रूट दिन भर बदलते रहते हैं। अगर 20 मिनट में कोई कोड नहीं आता, तो रकम वॉलेट में लौटा दी जाती है।
क्या +238 इंटीग्रेशन टेस्ट करने के लिए कोई sandbox है?
हाँ, अनुरोध पर। डेवलपमेंट अकाउंट को sandbox मोड पर स्विच किया जा सकता है, जो सिम्युलेटेड नंबर और कोड लौटाता है ताकि इंटीग्रेशन वॉलेट का खर्च किए बिना शुरू से अंत तक चल सके।
सेवाओं के नाम उनके संबंधित स्वामियों के ट्रेडमार्क हैं। OTP Route का उनसे कोई संबंध नहीं है। नंबरों का उपयोग कानूनी रूप से करें तथा प्रत्येक सेवा की शर्तों और हमारी स्वीकार्य उपयोग नीति का पालन करें।