استقبال رموز بوتسوانا النصية عبر استدعاء API

عبر أي استدعاءات API يمر تفعيل بوتسوانا؟

كل شيء تحت https://otproute.com/api/v1 ويُصادَق بمفتاح Bearer يبدأ بـ or_live_. تنشئ المفاتيح في وحدة تحكم المطورين؛ ويمكن للحساب أن يضم حتى 10 منها، والحد هو 300 طلب في الدقيقة، وهو أكثر من كافٍ لمجموعة اختبارات تطلب حفنة من الأرقام البوتسوانية في كل تشغيل.

يبدو التسلسل المعتاد هكذا:

1. استدعِ GET /api/v1/countries مرة واحدة وخزّنه مؤقتًا، ليعرف كودك أن bw هو معرّف بوتسوانا.
2. اسأل GET /api/v1/prices?country=bw&service=whatsapp عن السعر الحي وتوفر الزوج الذي تحتاجه. تختلف الأسعار بحسب الخدمة والدولة، فاقرأها بدل تثبيتها في الكود.
3. أرسل POST /api/v1/activations بالجسم {"service": "whatsapp", "country": "bw"}. تحمل الاستجابة رقم +267 ومعرّف التفعيل.
4. أدخل ذلك الرقم في نموذج التسجيل قيد الاختبار، ثم استعلم عبر GET /api/v1/activations/{id} أو انتظر ويب هوك.
5. إذا أُلغي الاختبار، استدعِ POST /api/v1/activations/{id}/cancel لتعود الأموال إلى المحفظة فورًا.

ويشرح دليل تكامل OTP API الاستدعاءات نفسها مع مراعاة معالجة الأخطاء.

كيف ينبغي أن يتعامل مستقبِل الويب هوك لدي مع أحداث +267؟

الويب هوك هي الخيار الأنظف حين يعمل أكثر من اختبار بالتوازي. سجّل نقطة نهاية (خمس لكل حساب) واستمع إلى activation.sms_received وactivation.expired وactivation.cancelled، وكلها مرتبطة بمعرّف التفعيل الذي حصلت عليه عند الطلب.

يحمل كل تسليم ترويسة X-OTPRoute-Signature بالصيغة t=<unix>,v1=<hex>. أعد بناء HMAC-SHA256 للسلسلة "<t>.<raw body>" بسر نقطة النهاية، وقارنه بـ v1 بزمن ثابت، وأسقط كل ما طابعه الزمني قديم. حلّل JSON بعد نجاح الفحص فقط، لأن إعادة تسلسل الجسم تغيّر البايتات.

اجعل المعالج idempotent: احفظ معرّف التفعيل عند استهلاك الرمز وتجاهل تكرار الحدث نفسه. التفاصيل في تأمين ويب هوك OTP بـ HMAC.

فيمَ يمكن استخدام رقم تحقق بوتسواني؟

تسرد اللقطة الحية لبوتسوانا أكثر من 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، واختر بوتسوانا والخدمة، وتحقق من السعر المعروض ثم اطلب. الصق الرقم في التطبيق الذي تختبره؛ يظهر الرمز في لوحة التحكم حالما تصل الرسالة النصية إلى المسار.

يبقى كل تفعيل مفتوحًا 20 دقيقة. وإذا لم تصل رسالة خلالها، أو ألغيت قبلها، يعود المبلغ كاملًا إلى محفظتك تلقائيًا.

ماذا لو لم يصل الرمز البوتسواني؟

تعتمد سرعة التسليم على الخدمة والمسار، فامنح النافذة وقتًا قبل التصرف. وإذا انتهت فارغة، فجرّب هذه القائمة:

• أعد المحاولة بعد قليل، أو اختر مسار خدمة آخر للمسار نفسه إن كان منتجك يدعم ذلك.
• تأكد من أن التطبيق في الطرف الآخر يقبل إرسال رسالة إلى خط افتراضي؛ فبعض التطبيقات يرفض هذه الأرقام، وهذا بالضبط سبب عودة التفعيلات غير المستخدمة إلى رصيدك.
• دع نافذة الـ 20 دقيقة تنتهي بدل الإلغاء بعد دقيقة.
• تجنّب إعادة الطلب في حلقة سريعة من CI؛ أضف تأخيرًا متزايدًا بين المحاولات.

مزيد من الأنماط في تقليل إخفاقات تسليم OTP. وأيًّا كان ما تختبره، التزم بشروط كل خدمة؛ فسياسة الاستخدام المقبول الخاصة بـ OTP Route تنطبق على كل طلب.

هل يوجد خط +267 طويل الأمد، وكيف تُدار الفوترة؟

ليس كمنتج بالخدمة الذاتية. تُباع الأرقام المخصصة فورًا في الولايات المتحدة وكندا فقط، بسعر يبدأ من $1.95 شهريًا؛ وبالنسبة إلى بوتسوانا يمكنك مراسلة [email protected] للسؤال، والتوفر يعتمد على القواعد المحلية. راجع الأرقام الافتراضية لمعرفة ما تتضمنه الخطوط الأمريكية والكندية.

الفوترة عبر محفظة واحدة مسبقة الدفع بالدولار الأمريكي دون رسوم شهرية، تُشحن ببطاقة أو بعملتي USDT/USDC، وتصاحب كل شحنة فاتورة PDF بالبريد الإلكتروني. وللعمل على التكامل، يمكن تحويل حساب التطوير إلى sandbox عند الطلب فيعمل المسار كاملًا على أرقام ورموز محاكاة. الأسعار الحالية في صفحة الأسعار.

الأسئلة الشائعة

ما معرّف دولة بوتسوانا في OTP Route API؟

هو bw. مرّره كـ country في POST /api/v1/activations وفي سلسلة استعلام GET /api/v1/prices.

هل يمكنني اختبار مسار التسجيل البوتسواني في تطبيقي دون شريحة محلية؟

نعم. اطلب رقم +267 لخدمة تطبيقك عبر OTP Gateway واقرأ الرمز في لوحة التحكم أو على الويب هوك لديك، دون أي شريحة أو هاتف.

هل تحتاج الأرقام البوتسوانية إلى صفر في البداية عند التخزين؟

لا. ليست لبوتسوانا بادئة خط، لذا خزّن الرقم على هيئة +267 بالإضافة إلى رقم الجوال المكوّن من ثمانية أرقام.

هل أُحاسَب إذا لم يصل رمز +267؟

لا. إذا لم يصل شيء خلال نافذة الـ 20 دقيقة، أو ألغيت، يعود المبلغ كاملًا إلى محفظتك تلقائيًا.

هل يمكنني الاحتفاظ برقم بوتسواني لتسجيلات دخول مستقبلية؟

لا يوجد رقم طويل الأمد بالخدمة الذاتية لبوتسوانا. الخطوط طويلة الأمد منتج للولايات المتحدة وكندا؛ راسل [email protected] إن أردت السؤال عن خيارات أخرى.

هل يمكنني تشغيل اختبارات بوتسوانا في CI دون إنفاق رصيد المحفظة؟

اطلب تحويل حساب التطوير إلى sandbox. فهو يُرجع أرقامًا ورموزًا محاكاة، ويمكن بذلك تجربة مسار API والويب هوك كاملًا دون تكلفة.

أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.