اردو
ایک API کال کے ذریعے بوٹسوانا کے SMS کوڈز وصول کرنا
جی ہاں، آپ OTP Route کے ذریعے بوٹسوانا (+267) کے SMS تصدیقی کوڈز وصول کر سکتے ہیں: OTP Gateway API یا ڈیش بورڈ کے ذریعے ملک bw کے لیے ایکٹیویشن بنائیں، اور کوڈ پولنگ یا دستخط شدہ ویب ہُک سے واپس آ جاتا ہے۔ قیمتیں $0.20 فی کوڈ سے شروع ہوتی ہیں، اور چارج تب ہی لگتا ہے جب SMS واقعی نمبر پر پہنچے۔
بوٹسوانا کا ایکٹیویشن کن API کالز سے گزرتا ہے؟
سب کچھ https://otproute.com/api/v1 کے تحت ہے اور or_live_ سے شروع ہونے والی Bearer کلید سے تصدیق ہوتی ہے۔ آپ کلیدیں Developer کنسول میں بناتے ہیں؛ ایک اکاؤنٹ میں 10 تک ہو سکتی ہیں، اور حد 300 درخواست فی منٹ ہے، جو ایسے ٹیسٹ سوٹ کے لیے کافی سے زیادہ ہے جو ہر رن میں بوٹسوانا کے چند نمبر آرڈر کرتا ہے۔
ایک عام ترتیب کچھ یوں ہے:
GET /api/v1/countriesایک بار کال کر کے کیش کر لیں، تاکہ آپ کے کوڈ کو معلوم ہو کہ بوٹسوانا کی شناختbwہے۔- جس جوڑی کی آپ کو ضرورت ہے اس کی لائیو قیمت اور دستیابی کے لیے
GET /api/v1/prices?country=bw&service=whatsappسے پوچھیں۔ قیمتیں سروس اور ملک کے لحاظ سے بدلتی ہیں، اس لیے انہیں ہارڈ کوڈ کرنے کے بجائے پڑھیں۔ {"service": "whatsapp", "country": "bw"}باڈی کے ساتھPOST /api/v1/activationsبھیجیں۔ جواب میں +267 نمبر اور activation id ہوتی ہے۔- وہ نمبر زیرِ ٹیسٹ سائن اپ فارم میں درج کریں، پھر یا تو
GET /api/v1/activations/{id}پول کریں یا ویب ہُک کا انتظار کریں۔ - اگر ٹیسٹ ادھورا چھوڑ دیا جائے تو
POST /api/v1/activations/{id}/cancelکال کریں تاکہ رقم فوراً والٹ میں لوٹ آئے۔
OTP API انٹیگریشن گائیڈ انہی کالز کو ایرر ہینڈلنگ کو ذہن میں رکھ کر بیان کرتی ہے۔
میرے ویب ہُک ریسیور کو +267 کے ایونٹس کیسے سنبھالنے چاہئیں؟
جب ایک سے زیادہ ٹیسٹ متوازی چلیں تو ویب ہُکس زیادہ صاف انتخاب ہیں۔ ایک اینڈ پوائنٹ رجسٹر کریں (فی اکاؤنٹ پانچ) اور activation.sms_received، activation.expired اور activation.cancelled سنیں، جن میں سے ہر ایک اس activation id پر مبنی ہے جو آپ کو آرڈر کرتے وقت ملی تھی۔
ہر ڈیلیوری میں X-OTPRoute-Signature ہیڈر ہوتا ہے جس کی شکل t=<unix>,v1=<hex> ہے۔ اینڈ پوائنٹ کے سیکرٹ سے سٹرنگ "<t>.<raw body>" کا HMAC-SHA256 دوبارہ بنائیں، constant time میں اس کا v1 سے موازنہ کریں، اور جس کا ٹائم اسٹیمپ پرانا ہو اسے رد کر دیں۔ JSON صرف جانچ پاس ہونے کے بعد پارس کریں، کیونکہ باڈی کو دوبارہ سیریلائز کرنے سے بائٹس بدل جاتے ہیں۔
ہینڈلر کو idempotent بنائیں: کوڈ استعمال ہونے پر activation id محفوظ کریں اور اسی ایونٹ کی تکرار کو نظر انداز کریں۔ تفصیل HMAC کے ساتھ OTP ویب ہُکس محفوظ بنانے میں ہے۔
بوٹسوانا کا تصدیقی نمبر کن کاموں کے لیے استعمال ہو سکتا ہے؟
بوٹسوانا کا لائیو اسنیپ شاٹ 800 سے زیادہ سروسز کی فہرست دیتا ہے۔ مقبول سروسز میں WhatsApp، Telegram، Google (Gmail & YouTube)، Facebook، Instagram، TikTok، ChatGPT (OpenAI)، Microsoft & Outlook، Amazon، LinkedIn، Uber، Signal، Netflix اور Airbnb شامل ہیں۔
کیریئر کی صلاحیت بدلنے کے ساتھ کسی روٹ کی دستیابی دن بھر بدلتی رہتی ہے۔ اسی لیے قیمتوں کا اینڈ پوائنٹ یہ بھی بتاتا ہے کہ ابھی کیا آرڈر ہو سکتا ہے: اس فہرست کے بجائے اس کے جواب کو مستند ماخذ سمجھیں۔
انجینئرز کو بوٹسوانا کے فون نمبروں کے بارے میں کیا جاننا چاہیے؟
بوٹسوانا کا کنٹری کوڈ +267 ہے اور اس میں ٹرنک پریفکس نہیں، اس لیے قومی نمبر ویسے ہی ڈائل ہوتا ہے جیسے لکھا جاتا ہے۔ موبائل نمبر آٹھ ہندسوں کے ہوتے ہیں اور 7 سے شروع ہوتے ہیں۔ E.164 میں یہ +267 اور اس کے بعد آٹھ ہندسے بنتے ہیں، ہٹانے کے لیے کوئی صفر نہیں۔
ان نمبروں کو محفوظ یا ویلیڈیٹ کرنے والے کے لیے چند عملی نکات:
- ان پٹ پر سب کچھ E.164 میں نارملائز کریں۔ صارفین
00267، اسپیس یا شروع میں پلس لکھ سکتے ہیں؛ موازنے یا ڈپلیکیٹ ہٹانے سے پہلے سب کو ایک معیاری شکل میں لے آئیں۔ - کسی ہمسایہ مارکیٹ کا ٹرنک پریفکس والا قاعدہ دوبارہ استعمال نہ کریں۔ جس ملک میں شروع کا صفر ہٹتا ہے وہاں سے نقل کیا گیا ویلیڈیٹر بوٹسوانا کی درست اندراجات کو رد کر دے گا۔
- انگریزی اور سیٹسوانا بنیادی زبانیں ہیں۔ عالمی ایپس کے کوڈز عموماً انگریزی میں آتے ہیں، لیکن آپ کے پارسر کو مقررہ الفاظ پر انحصار کرنے کے بجائے پیٹرن سے ہندسے نکالنے چاہئیں۔
ٹیمیں یہاں تب ٹیسٹ کرتی ہیں جب وہ جنوبی افریقہ کے خطے میں پروڈکٹ لانچ کر رہی ہوں، جنوبی افریقہ کے پار سرحد کے اُس طرف بیٹھے صارفین کی آن بورڈنگ جانچ رہی ہوں، یا ایسے علاقائی آپریشنز چلا رہی ہوں جنہیں ٹیسٹنگ کے لیے مقامی +267 نمبر چاہیے۔
کیا کوئی غیر ڈیولپر ڈیش بورڈ سے بوٹسوانا کا کوڈ آرڈر کر سکتا ہے؟
جی ہاں۔ اپنی ای میل اور چھ ہندسوں کے کوڈ (یا Google) سے سائن اپ کریں، والٹ ٹاپ اپ کریں، پھر OTP Gateway کھولیں، بوٹسوانا اور سروس چنیں، دکھائی گئی قیمت دیکھیں اور آرڈر کریں۔ نمبر کو اس ایپ میں پیسٹ کریں جسے آپ ٹیسٹ کر رہے ہیں؛ SMS روٹ تک پہنچتے ہی کوڈ ڈیش بورڈ میں ظاہر ہو جاتا ہے۔
ہر ایکٹیویشن 20 منٹ کھلی رہتی ہے۔ اگر اس دوران کوئی پیغام نہ آئے، یا آپ پہلے منسوخ کر دیں، تو پوری رقم خود بخود آپ کے والٹ میں واپس چلی جاتی ہے۔
اگر بوٹسوانا کا کوڈ نہ آئے تو کیا کریں؟
ڈیلیوری کی رفتار سروس اور روٹ پر منحصر ہے، اس لیے کچھ کرنے سے پہلے ونڈو کو وقت دیں۔ اگر یہ خالی بند ہو جائے تو یہ فہرست دیکھیں:
- تھوڑی دیر بعد دوبارہ کوشش کریں، یا اگر آپ کی پروڈکٹ اجازت دے تو اسی فلو کے لیے کوئی اور سروس روٹ چنیں۔
- تصدیق کریں کہ دوسری طرف کی ایپ ورچوئل لائن پر ٹیکسٹ بھیجنے پر آمادہ ہے؛ چند ایپس ایسے نمبروں کو لوٹا دیتی ہیں، اور استعمال نہ ہونے والی ایکٹیویشنز اسی لیے آپ کے بیلنس میں واپس آتی ہیں۔
- ایک منٹ بعد منسوخ کرنے کے بجائے 20 منٹ کی ونڈو مکمل ہونے دیں۔
- CI سے تیزی سے لوپ میں دوبارہ آرڈر نہ کریں؛ کوششوں کے درمیان بیک آف رکھیں۔
مزید نمونے ناکام OTP ڈیلیوری کم کرنے میں ہیں۔ آپ جو کچھ بھی ٹیسٹ کریں، ہر سروس کی شرائط کی پابندی کریں؛ OTP Route کی قابلِ قبول استعمال کی پالیسی (Acceptable Use Policy) ہر آرڈر پر لاگو ہے۔
کیا +267 کی طویل مدتی لائن ہے، اور بلنگ کیسے سنبھالی جاتی ہے؟
خود سروس پروڈکٹ کے طور پر نہیں۔ Dedicated Numbers فوری طور پر صرف ریاستہائے متحدہ اور کینیڈا میں بیچے جاتے ہیں، $1.95/month سے؛ بوٹسوانا کے لیے آپ [email protected] پر ای میل کر کے پوچھ سکتے ہیں، اور دستیابی مقامی قواعد پر منحصر ہے۔ امریکا اور کینیڈا کی لائنوں میں کیا شامل ہے، اس کے لیے ورچوئل نمبرز دیکھیں۔
بلنگ ایک پری پیڈ USD والٹ سے ہوتی ہے جس میں کوئی ماہانہ فیس نہیں، جسے کارڈ یا USDT/USDC سے ٹاپ اپ کیا جاتا ہے، اور ہر ٹاپ اپ پر ای میل سے PDF انوائس ملتی ہے۔ انٹیگریشن کے کام کے لیے درخواست پر ڈیولپمنٹ اکاؤنٹ کو سینڈ باکس پر کیا جا سکتا ہے تاکہ پورا فلو فرضی نمبروں اور کوڈز پر چلے۔ موجودہ نرخ قیمتوں کے صفحے پر ہیں۔
اکثر پوچھے گئے سوالات
OTP Route API میں بوٹسوانا کی کنٹری آئی ڈی کیا ہے؟
یہ bw ہے۔ اسے POST /api/v1/activations میں country کے طور پر اور GET /api/v1/prices کی کوئری سٹرنگ میں بھیجیں۔
کیا میں مقامی SIM کے بغیر اپنی ایپ کے بوٹسوانا سائن اپ فلو کی جانچ کر سکتا ہوں؟
جی ہاں۔ OTP Gateway کے ذریعے اپنی ایپ کی سروس کے لیے +267 نمبر آرڈر کریں اور کوڈ ڈیش بورڈ میں یا اپنے ویب ہُک پر پڑھیں، جس میں کسی SIM کارڈ یا فون کی ضرورت نہیں۔
کیا بوٹسوانا کے نمبروں کو محفوظ کرتے وقت شروع کا صفر چاہیے؟
نہیں۔ بوٹسوانا میں ٹرنک پریفکس نہیں، اس لیے نمبر کو +267 اور آٹھ ہندسوں والے موبائل نمبر کی شکل میں محفوظ کریں۔
اگر +267 کا کوڈ نہ آئے تو کیا مجھ سے چارج لیا جاتا ہے؟
نہیں۔ اگر 20 منٹ کی ونڈو میں کچھ نہ آئے، یا آپ منسوخ کر دیں، تو پوری رقم خود بخود آپ کے والٹ میں واپس آ جاتی ہے۔
کیا میں آئندہ لاگ اِن کے لیے بوٹسوانا کا نمبر اپنے پاس رکھ سکتا ہوں؟
بوٹسوانا کے لیے کوئی خود سروس طویل مدتی نمبر نہیں ہے۔ طویل مدتی لائنیں امریکا اور کینیڈا کی پروڈکٹ ہیں؛ دیگر اختیارات کے بارے میں پوچھنے کے لیے [email protected] پر ای میل کریں۔
کیا میں والٹ کی رقم خرچ کیے بغیر CI میں بوٹسوانا کے ٹیسٹ چلا سکتا ہوں؟
اپنے ڈیولپمنٹ اکاؤنٹ کو سینڈ باکس پر کرنے کو کہیں۔ یہ فرضی نمبر اور کوڈز واپس کرتا ہے، اس لیے مکمل API اور ویب ہُک راستہ بغیر کسی لاگت کے آزمایا جا سکتا ہے۔
سروسز کے نام اپنے اپنے مالکان کے ٹریڈ مارکس ہیں۔ OTP Route کا ان سے کوئی تعلق نہیں۔ نمبرز کو قانونی طور پر استعمال کریں اور ہر سروس کی شرائط اور ہماری قابلِ قبول استعمال کی پالیسی کی پابندی کریں۔