سحب رموز SMS الإثيوبية (+251) إلى خط الاختبار لديك

ما استدعاءات API التي تجلب رمز تحقق إثيوبيًا؟

يختصر توجيه OTP لإثيوبيا في خمسة استدعاءات HTTP بسيطة إلى https://otproute.com/api/v1. صادِق على كل واحد منها بمفتاح Bearer يبدأ بـ or_live_ منشأ في وحدة تحكم المطوّرين؛ ويتّسع الحساب لما يصل إلى 10 مفاتيح، فيمكن لـ CI وبيئة staging وحاسوبك المحلي أن تعمل كلٌّ بأوراق اعتماد منفصلة.

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

يتحرك المخزون خلال اليوم، فاستدعِ نقطة الأسعار وقت التشغيل بدل تثبيت أي قيمة. وبفحص سريع لـ GET /api/v1/balance قبل بدء المجموعة تستطيع المهمة أن تتوقف مبكرًا عند نفاد رصيد المحفظة. أشكال الطلبات والاستجابات لواجهة التحقق عبر SMS هذه موجودة في وثائق المطوّرين.

كيف أربط webhook موقّعًا لتفعيلات +251؟

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

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

افترض أن الحدث قد يُسلَّم أكثر من مرة: اربط المعالج بمعرّف التفعيل وأسقط التكرارات، حتى لا يملأ حدث أُعيدت محاولته حقل OTP مرتين. وإذا بقيت على الاستعلام الدوري، فإن فاصلًا من بضع ثوانٍ يبقى ضمن حد 300 طلب في الدقيقة بارتياح. ويتضمن شرحنا عن تأمين webhooks الخاصة بـ OTP عبر HMAC معالجًا مرجعيًا.

ما الخدمات التي تستقبل رموز SMS OTP الإثيوبية الآن؟

يعرض المسار الإثيوبي حاليًا أكثر من 1,700 خدمة. ومن العناصر الشائعة في اللقطة الحية WhatsApp وTelegram وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وChatGPT (OpenAI) وMicrosoft & Outlook وLinkedIn وUber وSignal وViber وimo وNetflix.

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

ما الذي ينبغي أن تعرفه فرق ضمان الجودة عن صيغ +251 ولغة الرسائل؟

الرقم الإثيوبي بصيغة E.164 هو +251 يليه تسعة أرقام. وفي الاتصال المحلي يضع الناس 0 أمام هذه الأرقام التسعة، فيكتب المستخدمون غالبًا 09… في نموذجك. احذف صفر البادئة المحلية، وأضف +251، وخزّن سلسلة E.164 القياسية، ولا تعرض النمط المحلي إلا في الواجهة. غطِّ المدخلين معًا، إضافةً إلى المسافات والشرطات، فحقل التحقق من الهاتف هو المكان الذي تختبئ فيه أخطاء كثيرة في التسجيل.

الأمهرية هي لغة العمل الاتحادية وتُكتب بالخط الإثيوبي (الجعز)، بينما تُستخدم الأورومية والتغرينية والصومالية على نطاق واسع في أقاليمها. ترسل معظم الخدمات الدولية الرموز بالإنجليزية، غير أن قالبًا مترجمًا قد يصل بالأمهرية. استخرج الأرقام بنمط بدل مطابقة الكلمات المحيطة، وتأكد من أن سجلاتك تخزّن UTF-8 بشكل سليم.

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

هل يستطيع غير المطوّرين الحصول على رقم تحقق إثيوبي من لوحة التحكم؟

نعم. يستطيع مديرو المنتج وموظفو الدعم تنفيذ المسار نفسه دون كتابة كود:

1. أنشئ حسابًا ببريدك الإلكتروني ورمز من 6 أرقام، أو عبر تسجيل الدخول بحساب Google، ثم فعّل المصادقة الثنائية TOTP.
2. أضف رصيدًا إلى المحفظة.
3. اختر إثيوبيا، ثم الخدمة، واقرأ السعر المعروض قبل التأكيد.
4. الصق رقم +251 في التطبيق الذي تتحقق منه.
5. أبقِ التفعيل مفتوحًا؛ إذ يُعرض الرمز هناك بمجرد استلامه.

تستخدم فرق كثيرة هذا المسار لفحوص سريعة لمرة واحدة بينما يقود المهندسون المسار ذاته عبر API.

ماذا يحدث عندما لا يظهر رمز +251؟

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

عندما لا يصل شيء:

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

يسرد المقال عن تقليل إخفاقات تسليم OTP فحوصات إضافية.

هل يوجد خط إثيوبي طويل الأمد، وكيف تُدار الفوترة؟

لا تقدّم OTP Route رقمًا طويل الأمد بالخدمة الذاتية في إثيوبيا. الأرقام المخصصة (Dedicated Numbers)، وهي خطوط تحتفظ بها ما دامت تُجدَّد، منتج للولايات المتحدة وكندا يبدأ من $1.95/month. وإذا كان فريقك يحتاج إلى خط +251 دائم، فراسل [email protected] للاستفسار؛ والتوفر يعتمد على القواعد المحلية وغير مضمون.

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

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

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

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

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

ما معرّف إثيوبيا في واجهة OTP Route البرمجية؟

إنه et. أرسل et في الحقل country عند إنشاء تفعيل إثيوبي وعند الاستعلام عن الأسعار.

كم يكلّف رقم +251 للاختبار؟

تبدأ الرموز من $0.20 للرمز. ويُعاد المبلغ الدقيق لكل خدمة عبر GET /api/v1/prices ويظهر في لوحة التحكم قبل الطلب.

هل أخزّن أرقام الهاتف الإثيوبية بالصفر البادئ؟

لا. احتفظ بصيغة E.164، أي +251 وتسعة أرقام، واحذف الصفر المحلي كلما كتبه المستخدم. طبّق التنسيق المحلي على الشاشة فقط.

هل ستصل نصوص التحقق الإثيوبية بالأمهرية؟

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

هل أستطيع الاحتفاظ برقم إثيوبي لتسجيلات دخول لاحقة؟

ليس بالخدمة الذاتية، لأن الرقم لمرة واحدة يغطي رمزًا واحدًا فقط. وللحساب الذي يلزمه تسجيل دخول متكرر يناسبه رقم مخصص (Dedicated Number) في الولايات المتحدة أو كندا، أو يمكنك مراسلة الدعم للسؤال عن إثيوبيا.

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

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

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