اختيار المسار الأنسب لرموز التحقق الأوكرانية (+380)

هل تحتاج حالات الاختبار الأوكرانية رقمًا لمرة واحدة أم خطًّا طويل الأمد؟

ابدأ بهذا السؤال لأنه يحدد كل ما بعده. يستقبل رقم OTP Gateway لمرة واحدة رمز تحقق واحدًا ثم يُغلق. أما الخط طويل الأمد فتحتفظ به وتسجّل به الدخول مجددًا بعد أشهر.

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

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

لماذا تختبر فرق الهندسة بأرقام +380؟

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

• اختبار الجودة باللغة الأوكرانية: الأوكرانية هي لغة الدولة، والفرق التي تعرّب خطوات التسجيل تريد رؤية خطوة الهاتف الحقيقية بنص سيريلي حولها.
• مستخدمو المهجر: يعيش أصحاب أرقام +380 اليوم في بولندا وألمانيا ودول أوروبية أخرى، فيصادف تطبيق أُطلق في مكان آخر أرقامًا أوكرانية عند التسجيل.
• المسارات كثيفة المراسلة: يستخدم الأوكرانيون Telegram وViber على نطاق واسع، فهما هدفان شائعان للاختبار في المنتجات التي تتكامل مع أحدهما.

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

كيف تُوحَّد أرقام +380؟

تُكتب الأرقام الأوكرانية محليًا ببادئة محلية 0 يليها تسعة أرقام، مثلًا بالشكل 0XX XXX XX XX. وفي الصيغة الدولية يسقط الصفر: +380 يليه الرقم الوطني من تسعة أرقام. لاحظ أن رمز الدولة نفسه ينتهي بالصفر، وهذا يربك بعض أدوات التحقق المكتوبة يدويًا.

إرشادات:

• خزّن سلسلة E.164 فقط؛ ونسّق بالمسافات أو بصفر البادئة وقت العرض.
• إذا كتب المستخدم 0… بعد اختيار +380، فأزل صفرًا بادئًا واحدًا بالضبط.
• احذر من +3800…، فهي علامة على أن البادئة المحلية لم تُحذف.
• تحقق من الطول بمكتبة مصانة بدل تعابير نمطية منسوخة من مكان آخر.

ما الخدمات التي يمكن أن يستقبلها رقم تحقق أوكراني؟

تُحصي اللقطة الحية أكثر من 1,500 خدمة لأوكرانيا. ومن الشائعة منها Telegram وViber وWhatsApp وSignal وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وDiscord وLinkedIn وMicrosoft & Outlook وUber وChatGPT (OpenAI) وClaude.

ما هو معروض يتغير على مدار اليوم، فاعتبر هذا مثالًا ودع API يخبرك بما هو متاح حاليًا.

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

تذهب طلبات أرقام +380 إلى https://otproute.com/api/v1، موقّعة بمفتاح Bearer بادئته or_live_ يُنشأ في وحدة تحكم المطورين. ومعرّف الدولة لأوكرانيا هو ua.

تسلسل نظيف: اعرف المعرّفات بـ GET /api/v1/services وGET /api/v1/countries؛ واقرأ التكلفة والتوفر من GET /api/v1/prices?country=ua&service=<id>؛ وتأكد من الرصيد بـ GET /api/v1/balance؛ ثم أرسل POST /api/v1/activations مع {"service": "viber", "country": "ua"}. يحمل الرد رقم +380 ومعرّف التفعيل.

وللتسليم اختر بين الاستعلام الدوري عبر GET /api/v1/activations/{id} وويب هوك مشترك في activation.sms_received وactivation.expired وactivation.cancelled. يحمل كل ويب هوك X-OTPRoute-Signature: t=<unix>,v1=<hex>؛ تحقق منه بوصفه HMAC-SHA256 على <t>.<raw body> بسرّ نقطة النهاية، وارفض الطوابع الزمنية القديمة، وعالج كل معرّف تفعيل مرة واحدة. يسمح الحساب بـ 10 مفاتيح و5 نقاط نهاية و300 طلب في الدقيقة. التفاصيل الكاملة في الوثائق.

ما مسار لوحة التحكم لغير المطورين؟

يستطيع فريقا الدعم والنمو تجاوز API تمامًا. افتح OTP Gateway في لوحة التحكم، واختر أوكرانيا والخدمة، وراجع السعر المعروض، ثم اطلب. أدخل رقم +380 في التطبيق واطلب الرسالة، ويظهر الرمز في صفحة التفعيل عند وصوله.

ماذا لو لم يصل الرمز، وكيف تُدار الفوترة؟

يبقى التفعيل مفتوحًا 20 دقيقة، ولا تدفع إلا عند وصول رمز. وإذا أُغلقت النافذة فارغة، أو استدعيت POST /api/v1/activations/{id}/cancel، يعود المبلغ كاملًا إلى المحفظة.

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

تأتي الأموال من محفظة واحدة مسبقة الدفع بالدولار الأمريكي دون رسوم شهرية. يعمل الشحن ببطاقة أو بـ USDT/USDC، وتصل فاتورة PDF إلى بريدك بعد كل عملية. وعند الطلب يمكن تشغيل حساب التطوير في الوضع التجريبي (sandbox) بأرقام ورموز محاكاة، وهو مفيد عند ربط مسارات CI. OTP Route مخصص لمنتجاتك وحساباتك المشروعة: التزم بشروط كل خدمة وبسياسة الاستخدام المقبول.

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

هل يمكنني استقبال رموز OTP النصية من أوكرانيا دون شريحة أوكرانية؟

نعم. اطلب رقم +380 من OTP Gateway واقرأ الرمز في لوحة التحكم أو عبر API.

ما معرّف الدولة الذي يستخدمه OTP Route لأوكرانيا؟

استخدم ua في استعلامات الأسعار وفي جسم POST /api/v1/activations.

هل الصفر البادئ جزء من رقم +380؟

فقط في الاتصال المحلي. في E.164 تخزّن +380 يليه تسعة أرقام دون صفر إضافي.

كم يكلّف رقم التحقق من أوكرانيا؟

تبدأ الأسعار من $0.20 للرمز، وتُعيد API الرقم الحي الدقيق لكل خدمة.

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

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

هل سأخسر مالًا إذا لم يرسل Telegram الرمز أبدًا؟

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

هل يمكنني اختبار التسجيل باللغة الأوكرانية من البداية إلى النهاية في CI؟

نعم، باستدعاء API من مجموعة اختباراتك، ويتيح لك حساب sandbox التدرب على المسار برموز محاكاة أولًا.

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