ربط مسار التحقق عبر SMS في مصر (+20) بواجهة OTP Route البرمجية

ما الطلبات التي يحتاجها تكامل واجهة OTP لمصر فعلًا؟

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

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

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

كيف أستهلك رموز +20 من Webhook موقّع بدل الاستعلام الدوري؟

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

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

اعتبر معرّف التفعيل مفتاح عدم التكرار (idempotency): خزّن الحدث مرة واحدة، وتجاهل التكرارات، وأعد 2xx بسرعة. ويشرح دليل التقاط OTP عبر Webhook نسخة من هذا المعالج مدعومة بطابور.

ما الخدمات التي يمكنها إرسال رموز إلى رقم تحقق مصري؟

تسرد اللقطة الحية لمصر أكثر من 1,600 خدمة إجمالًا. ومن الشائعة التي تختبرها الفرق على أرقام +20: WhatsApp وFacebook وInstagram وTikTok وTelegram وGoogle (Gmail & YouTube) وMicrosoft & Outlook وUber وSnapchat وViber وimo وChatGPT (OpenAI) وAmazon وLinkedIn.

هذه القائمة لقطة في لحظة زمنية لا وعد. فخدمة لديها أرقام هذا الصباح قد تشحّ بعد الظهر، ولهذا تُبلغ نقطة الأسعار بالإتاحة إلى جانب التكلفة. وبعض الخدمات ترفض الأرقام الافتراضية كليًا؛ وعندئذٍ تغطيك قاعدة الاسترداد الموضحة أدناه.

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

تستخدم مصر رمز الدولة +20 وبادئة خط رئيسي محلية هي 0. فيُكتب رقم المحمول محليًا بأحد عشر رقمًا تبدأ بـ 01، بينما في الصيغة الدولية يختفي الصفر وتلي +20 عشرة أرقام. وتتجنب بضع عادات معظم الأخطاء:

• احفظ بصيغة E.164 فقط، مثل +201XXXXXXXXX، ونسّق للعرض وقت الرسم.
• أزل صفر الخط الرئيسي حين يدخل المستخدم 01… والدولة مضبوطة على مصر مسبقًا؛ وإلا انتهيت بقيمة غير صالحة +2001….
• وحّد الأرقام. قد يكتب مستخدمو لوحات المفاتيح العربية أرقامًا هندية-عربية، فحوّلها إلى أرقام ASCII قبل التحقق وقبل مقارنة رمز OTP المُدخل.

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

هل يستطيع فريق العمليات طلب رقم مصري دون كتابة شيفرة؟

نعم. ليس كل فحص بحاجة إلى نص برمجي، ويستطيع زملاء الدعم أو النمو استخدام OTP Gateway نفسه من المتصفح:

1. سجّل ببريدك الإلكتروني والرمز المكوّن من 6 أرقام، أو عبر Google.
2. اشحن المحفظة وافتح OTP Gateway.
3. اختر مصر والخدمة؛ يظهر السعر قبل أن تؤكد.
4. انسخ رقم +20 إلى التطبيق وانتظر ظهور الرمز على الشاشة.

التفعيل مطابق لطلب عبر الواجهة البرمجية، فيتصرف الفحص اليدوي والآلي بالطريقة نفسها.

ماذا لو لم يظهر رمز +20؟

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

حين تتكرر إخفاقات الرموز:

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

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

لماذا تختبر فرق المنتج مقابل أرقام مصرية؟

مصر من أكبر الأسواق الناطقة بالعربية، فهي محطة أولى طبيعية للفرق التي تعرّب منتجها إلى العربية. ورقم +20 حقيقي يختبر الأجزاء التي تتجاوزها المحاكيات: منتقي الدول، والتعامل مع صفر الخط الرئيسي، وقوالب SMS العربية، وتخطيط الواجهة من اليمين إلى اليسار في شاشة إدخال الرمز.

وتستخدم فرق العمليات الإقليمية كذلك توجيه OTP للتأكد من أن مسار التسجيل لا يزال يعمل للعملاء المصريين بعد كل إصدار، وتفحص الشركات التي تخدم مصريين في الخارج أن رقم +20 مقبول خارج البلد أيضًا.

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

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

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

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

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

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

ما معرّف الدولة الذي تستخدمه واجهة OTP Route لمصر؟

مصر هي eg. مرّره إلى نقطة الأسعار وفي جسم POST /api/v1/activations.

هل أدفع مقابل رقم +20 إذا لم تصل الرسالة؟

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

هل أحتفظ بالصفر الأول عند حفظ رقم محمول مصري؟

لا. الصفر 0 بادئة خط رئيسي محلية؛ احذفه وخزّن الرقم بصيغة E.164 التي تبدأ بـ +20.

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

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

هل أستطيع استخدام الأرقام المصرية لفتح حسابات كثيرة على منصة ما؟

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

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