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

ما الذي ينبغي أن تتضمنه قائمة الفحص قبل أول طلب +372؟

معظم عمليات الاختبار الفاشلة تعود إلى شيء ناقص قبل أن يُطلب الرقم أصلًا. أنجز هذه البنود أولًا:

• مفتاح API منشأ في وحدة تحكم المطوّرين. يحمل كل مفتاح البادئة or_live_ ويُرسل كرمز Bearer؛ ومع إتاحة 10 مفاتيح لكل حساب، يستحق مشغّل CI مفتاحًا خاصًا به.
• نقطة نهاية webhook مع تخزين سرّها في جهة الخادم، إذا فضّلت أن يُستدعى نظامك بدل الاستعلام الدوري. يُسمح بخمس نقاط نهاية لكل حساب.
• المعرّفات الصحيحة. إستونيا هي ee في كل طلب، ومعرّف الخدمة يأتي من GET /api/v1/services.
• فحص سعر حي. استدعِ GET /api/v1/prices?country=ee&service=<id> ليعرف المهمة التكلفة قبل أن تلتزم بأموال المحفظة.
• Sandbox، إذا كنت لا تزال في مرحلة الربط. يمكن عند الطلب تحويل حساب التطوير إلى وضع sandbox، فيعيد أرقامًا ورموزًا محاكاة من البداية إلى النهاية دون المساس برصيدك.
• ميزانية معدّل الطلبات. تقبل الواجهة 300 طلب في الدقيقة لكل حساب، وهو أكثر من كافٍ ما لم تستعلم مجموعة الاختبارات بإهمال.

يتناول دليل تكامل OTP API كل بند من هذه بتفصيل أكبر.

كيف أنفّذ طلب OTP API لإستونيا من البداية إلى النهاية؟

بعد إنهاء قائمة الفحص يصبح تسلسل الاستدعاءات قصيرًا:

1. POST /api/v1/activations بالمحتوى {"service": "<id>", "country": "ee"}. تحمل الاستجابة معرّف التفعيل ورقم +372 الذي تكتبه في نموذج التسجيل أو الدخول قيد الاختبار.
2. شغّل إرسال رسالة التحقق من التطبيق الذي تختبره.
3. انتظر الرمز. إما أن تتلقى نقطة نهايتك الحدث activation.sms_received، أو تستدعي GET /api/v1/activations/{id} بفاصل زمني معقول.
4. أدخل الرمز في التطبيق وسجّل النتيجة مقابل معرّف التفعيل.
5. إذا تغيّر مسار الاختبار ولم تعد بحاجة إلى الرقم، فاستدعِ POST /api/v1/activations/{id}/cancel ليُفكّ الحجز فورًا.

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

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

تُظهر اللقطة الحية لإستونيا أكثر من 1,700 خدمة. ومن المسارات الشائعة WhatsApp وTelegram وGoogle (Gmail & YouTube) وFacebook وInstagram وLinkedIn وMicrosoft & Outlook وAmazon وDiscord وSignal وUber وAirbnb وChatGPT (OpenAI).

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

كيف تُخزَّن أرقام +372 وتُتحقَّق؟

خطة الترقيم في إستونيا من أبسط الخطط تعاملًا، ولهذا تحديدًا تفشل فيها المدقّقات المتهاونة. لا توجد بادئة محلية (trunk prefix) لحذفها: فالرقم المكتوب محليًا هو نفسه الأرقام التي تضيفها بعد +372. تبدأ أرقام الجوال عادةً بالرقم 5 ويبلغ طولها سبعة أو ثمانية أرقام، لذا فإن تعبيرًا نمطيًا يصرّ على طول وطني ثابت سيرفض مدخلات صالحة.

قواعد عملية لنماذجك وقاعدة بياناتك:

• خزّن سلسلة E.164 كاملة مثل +3725xxxxxxx، واحتفظ بمدخل المستخدم الخام منفصلًا إن احتجته للدعم.
• لا تضف صفرًا في البداية أبدًا؛ فلا شيء يُحذف أو يُضاف.
• اختبر طولي الجوال، سبعة أرقام وثمانية، في أقنعة الإدخال لديك.

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

لماذا تختبر الفرق مسارات التسجيل على أرقام إستونية؟

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

من الأسباب المعتادة لطلب قائد ضمان الجودة رقم +372 للاختبار:

• التأكد من أن قوائم اختيار الدول وأقنعة الهاتف وقوالب الرسائل تعمل في سوق أوروبي ذي خطة ترقيم قصيرة.
• فحوص التوطين للنص الإستوني قبل إصدار إقليمي.
• إعادة إنتاج تذكرة دعم من عميل إستوني لم يصله رمزه.

اطلع على اختبار الجودة لمعرفة كيف تدمج الفرق هذه الفحوص في دورة الإصدار.

ماذا أفحص عندما لا يظهر الرمز؟

عالج المشكلة بالترتيب بدل طلب رقم بعد رقم:

1. اترك النافذة تعمل. يبقى التفعيل مفتوحًا 20 دقيقة، وبعض الخدمات تضع رسائلها في طابور.
2. تأكد من أن الخدمة تقبل الأرقام الافتراضية. بعض الخدمات ترفضها بحكم سياستها؛ وهذا سبب وجود الاسترداد.
3. انظر إلى الحالة النهائية. الحدث activation.expired، أو حالة منتهية من استدعاء GET، يعني أنه لم تصل أي رسالة وأن المال عاد فعلًا إلى المحفظة.
4. أعد المحاولة بصبر. جرّب لاحقًا بقليل، أو جرّب مسارًا آخر للخدمة نفسها، بدل إعادة الطلب في حلقة متلاحقة.
5. افحص المُشغّل لديك. اختبار لم يطلب الرسالة فعليًا يبدو مطابقًا لرمز مفقود.

يسرد مقالنا عن تقليل إخفاقات تسليم OTP أسبابًا أخرى تستحق استبعادها.

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

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

تجري الفوترة لتوجيه OTP عبر محفظة واحدة مدفوعة مسبقًا بالدولار الأمريكي، دون رسوم شهرية ودون خطة تختارها. اشحنها بالبطاقة أو بعملتي USDT أو USDC، وكل عملية شحن تولّد فاتورة PDF بالبريد. الأسعار الحالية في صفحة الأسعار، ومرجع نقاط النهاية في الوثائق.

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

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

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

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

استخدم ee كقيمة country في طلبات التفعيل والأسعار.

هل في أرقام الهاتف الإستونية بادئة محلية يجب حذفها؟

لا. ليس في إستونيا بادئة محلية، لذا تتبع الأرقام المحلية الرمز +372 كما هي دون تغيير.

هل أُحاسَب إذا لم يصل رمز إستوني؟

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

هل يستطيع غير المطوّر طلب رقم تحقق إستوني؟

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

هل يمكن تجربة التكامل الإستوني قبل إنفاق أموال حقيقية؟

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

ما القواعد التي تحكم طريقة استخدامي لهذه الأرقام؟

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

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