قائمة فحص مسبق لاستقبال رموز التحقق +375 من بيلاروسيا

ما الذي ينبغي تجهيزه قبل طلب رقم +375؟

قبل استخدام رقم +375 للاختبار، تحقق من هذه البنود:

• حساب ومحفظة ممولة. أنشئ حسابًا في /signup ببريد إلكتروني ورمز من 6 أرقام يصلك بالبريد، أو عبر تسجيل الدخول بـ Google، ثم أضف رصيدًا صغيرًا. فعّل المصادقة الثنائية TOTP للحساب الذي يحمل مفاتيح API.
• مفتاح Bearer ببادئة or_live_ يُنشأ في وحدة تحكم المطورين. أعطِ CI والتطوير المحلي مفتاحين منفصلين؛ ويمكن للحساب أن يضم حتى 10.
• المعرّفان اللذان سترسلهما. بيلاروسيا هي by في API، ومعرّف الخدمة هو قيمة api_service التي يُرجعها GET /api/v1/services.
• نقطة استقبال إن كنت تنوي استخدام الويب هوك، مع حفظ سر توقيعها خارج المستودع.
• حساب اختبار في منتجك يُسمح له بتغيير رقم الهاتف أو إضافته.
• مكتبة هاتف مضبوطة على المنطقة BY، لكي يُحلَّل الرقم الذي تلصقه في نموذج التسجيل كما سيكتبه مستخدم بيلاروسي حقيقي.

كيف تُكتب الأرقام البيلاروسية، وكيف ينبغي لتطبيقك تخزينها؟

تستخدم بيلاروسيا رمز الدولة +375 متبوعًا برقم وطني من تسعة أرقام. تبدأ خطوط الجوال برموز مشغّلين مثل 25 أو 29 أو 33 أو 44، فتبدو القيمة المخزنة هكذا +37529XXXXXXX.

الجزء الصعب هو العادة المحلية. فالناس داخل البلاد يكتبون غالبًا رقم الجوال ببادئة 80 في أوله، كما في 8 029 XXX-XX-XX، وهي مأخوذة من بادئة الاتصال بعيد المدى. يجب حذف هذه الـ 80 قبل إضافة رمز الدولة؛ فالنموذج الذي يُبقيها يُنتج سلسلة E.164 غير صالحة ترفضها بعض خدمات التحقق بصمت. اختبارات توحيد جيدة لرقم تحقق بيلاروسي:

• اقبل +375 29 ... و375 29 ... و8 029 ... وخزّن الثلاثة بالصيغة نفسها؛
• اعرض الرقم بتجميع مألوف محليًا لكن أرسل صيغة E.164 فقط إلى طبقة الرسائل أو التحقق لديك؛
• ارفض أي رقم ما زال فيه 80 بعد 375.

البيلاروسية والروسية كلتاهما لغة رسمية، والروسية هي الأكثر استخدامًا يوميًا. وترسل خدمات كثيرة نص الرمز بالروسية أو الإنجليزية حسب إعدادات الحساب، فتأكد من أن تطبيقك يعرض الحروف السيريلية بشكل صحيح في أي شاشة تعرض الرسالة.

لأي الخدمات يستطيع رقم تحقق بيلاروسي استقبال الرموز؟

يغطي توجيه OTP لبيلاروسيا على OTP Route حاليًا أكثر من 1,400 خدمة تحت المعرّف by. ومن المسارات الشائعة في اللقطة الحالية Telegram وViber وWhatsApp وSignal وGoogle (Gmail وYouTube) وInstagram وTikTok وMicrosoft وOutlook وLinkedIn وDiscord وAmazon وAliExpress.

يتغير التوفر على أي مسار منفرد خلال اليوم، فاعتبر قائمة كهذه نقطة بداية لا وعدًا. وقبل التشغيل، اسأل GET /api/v1/prices?country=by&service=<id> عن السعر الحالي وعمّا إذا كان المسار يستطيع قبول طلب الآن. راجع توجيه OTP حسب الدولة عند الاختيار بين الدول.

خطوة بخطوة: مسار OTP API لبيلاروسيا من سكربت اختبار

يذهب كل طلب إلى https://otproute.com/api/v1 مع مفتاح Bearer. واجهة التحقق عبر الرسائل النصية صغيرة بما يكفي لتغليفها في دالة مساعدة واحدة:

1. استدعِ GET /api/v1/balance وأوقف المهمة مبكرًا إذا كان رصيد المحفظة أقل من اللازم لمجموعة الاختبارات.
2. استدعِ GET /api/v1/prices?country=by&service=telegram (واستبدل معرّف خدمتك) وسجّل السعر الذي أنت على وشك دفعه.
3. أنشئ الطلب عبر POST /api/v1/activations وجسم مثل {"service": "telegram", "country": "by"}. واحفظ معرّف التفعيل ورقم +375 من الاستجابة.
4. أرسل ذلك الرقم إلى خطوة الهاتف في تطبيقك وشغّل إرسال الرمز.
5. اجمع الرمز من الحدث activation.sms_received، أو استعلم عبر GET /api/v1/activations/{id}. الحد هو 300 طلب في الدقيقة.
6. إذا توقف الاختبار، استدعِ POST /api/v1/activations/{id}/cancel ليعود المبلغ المحجوز إلى المحفظة فورًا.

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

خطوة بخطوة: المهمة نفسها من لوحة التحكم

يستطيع موظفو الدعم الذين يحتاجون إلى رمز بين حين وآخر تجاوز API:

1. افتح OTP Gateway في لوحة التحكم واختر بيلاروسيا.
2. اختر الخدمة؛ يظهر سعر ذلك المسار قبل أن تؤكد.
3. انسخ رقم +375 وأدخله في التطبيق الذي تختبره.
4. راقب بطاقة الطلب. يظهر الرمز هناك حالما يصل.

إذا لم يصل شيء خلال 20 دقيقة، يُغلق الطلب ويُعاد المبلغ كاملًا. أنت تدفع فقط عند تسليم رمز.

استكشاف الأخطاء: لم يصل رمز +375

الأسباب المعتادة والخطوة التالية لكل منها:

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

وتُغطّى أنماط فشل إضافية لطلبات +375 في تقليل إخفاقات تسليم OTP.

هل يوجد خط بيلاروسي طويل الأمد، وكيف تعمل الفوترة؟

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

تسحب الطلبات البيلاروسية من المحفظة المسبقة الدفع بالدولار الأمريكي نفسها كأي مسار آخر، دون أي رسوم شهرية ودون مستوى لاختياره. موّلها ببطاقة أو بعملتي USDT/USDC المستقرتين؛ وتصل فاتورة PDF عن كل شحنة إلى بريدك. ويمكن للمطورين طلب حساب sandbox يُرجع أرقامًا ورموزًا محاكاة، وهو أرخص طريقة لإثبات التكامل قبل الطلبات الحقيقية. استخدم كل رقم لمنتجك الخاص أو لحساباتك المشروعة فقط، والتزم بشروط كل خدمة، وتذكّر أن سياسة الاستخدام المقبول الخاصة بـ OTP Route تنطبق. الأرقام الحالية في الأسعار.

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

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

نعم. اطلب رقم +375 لخدمتك من OTP Gateway، وأرسله في نموذج التسجيل، واقرأ الرمز في لوحة التحكم أو عبر API.

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

هو by. استخدمه في GET /api/v1/prices وفي جسم POST /api/v1/activations.

هل أخزّن الأرقام البيلاروسية ببادئة 80؟

لا. خزّنها بصيغة E.164 على هيئة +375 متبوعًا بتسعة أرقام واحذف 80 المحلية، وإلا ستعتبر خدمات كثيرة الرقم غير صالح.

ماذا يحدث لأموالي إذا لم يتلقَّ رقم +375 أي رمز؟

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

بأي لغة ستكون رسالة التحقق النصية؟

تقرر ذلك الخدمة المرسِلة. وللأرقام البيلاروسية تكون عادةً بالروسية أو الإنجليزية، بحسب لغة الحساب أو الجهاز.

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

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

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

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

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