جمع رموز التحقق اليمنية (+967) عبر واجهة برمجية

ما أقصر مسار عبر الواجهة البرمجية إلى رمز +967؟

وجّه عميلك إلى https://otproute.com/api/v1 بمفتاح Bearer من Developer console؛ وتحمل المفاتيح البادئة or_live_. ومعرّف بلد اليمن هو ye.

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

نادراً ما يتغير GET /api/v1/services وGET /api/v1/countries، فاحفظهما مؤقتاً ليوم كامل. واستدعاء GET /api/v1/balance قبل دفعة من الطلبات يتيح للمهمة التوقف مبكراً حين ينخفض الرصيد. ويسري حد الـ 300 طلب في الدقيقة على كل حساب، ويمكن إصدار حتى 10 مفاتيح. راجع دليل التكامل لمثال عملي على مسار واجهة OTP API لليمن هذا.

كيف أتحقق من عمليات تسليم webhook لتفعيلات اليمن؟

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

يتبع فحص التوقيع وصفة واحدة. قسّم X-OTPRoute-Signature إلى t وv1، واحسب HMAC-SHA256 للسلسلة <t>.<raw body> بسر نقطة الوصول، وقارن الناتج بـ v1 بدالة زمن ثابت. ارفض الطلب إذا كان الطابع الزمني أقدم من هامش التسامح لديك. ولأن عملية التسليم قد تُعاد، اجعل المعالج غير مؤثر عند التكرار: خزّن معرّف التفعيل وتجاهل التكرارات. ويغطي تأمين webhooks الخاصة بـ OTP باستخدام HMAC الحالات الحدّية مثل انحراف الساعة.

ماذا ينبغي أن يتوقع محللي من الرسائل المكتوبة بالعربية؟

العربية هي اللغة الرسمية في اليمن، لذا ترسل خدمات كثيرة النص المحيط بالرمز بالعربية. ولهذا نتائج عملية لكل من يختبر رسائله هو: فالكتابة العربية تحتاج ترميز UCS-2 الذي يحدد جزء SMS الواحد بـ 70 حرفاً، وقد يُغيّر النص من اليمين إلى اليسار موضع ظهور الرمز في الإشعار. بعض القوالب تضع الأرقام قبل الجملة وبعضها بعدها.

اكتب خطوة الاستخراج بحيث تجد سلسلة الأرقام مهما كانت الكلمات المحيطة بها. ومن الحكمة أيضاً تحويل الأرقام الهندية العربية (٠ إلى ٩) إلى أرقام ASCII تحسباً لاستخدام مرسل لها. وتجري الفرق هذه الفحوصات عند توطين تطبيق للناطقين بالعربية، أو دعم عملاء يمنيين يقيمون في أنحاء الخليج، أو التأكد من أن حساب دعم إقليمي ما زال يتحقق. ويعيد OTP Route الرسالة كما استُلمت، فما تحلله في الاختبار هو ما سيصل إلى المستخدم.

كيف تُنسَّق أرقام الهواتف اليمنية؟

رمز البلد هو +967. تتكون أرقام الجوال من تسعة أرقام بعده وتبدأ بالرقم 7، فتأخذ الشكل +967 7XX XXX XXX. وإذا أدخل المستخدم صفراً محلياً في البداية فأزله قبل الحفظ، واحفظ سلسلة E.164 دون فواصل؛ أما التنسيق المحلي فمكانه الواجهة فقط.

حالات تحقق مفيدة لرقم +967 للاختبار:

• يختار المستخدم +967 من قائمة البلدان ثم يكتب الرقم كاملاً بما فيه الرمز مرة أخرى.
• يُلصق رقم بأرقام هندية عربية منسوخة من بطاقة اتصال.
• تظهر مسافات أو شرطات بين مجموعات الأرقام.

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

ما الخدمات الموجَّهة حالياً إلى أرقام +967؟

في اليمن أكثر من 1,700 خدمة على OTP Gateway. ومن الإدخالات الشائعة الاستخدام في اللقطة الحية WhatsApp وTelegram وimo وFacebook وInstagram وTikTok وSnapchat وGoogle (Gmail & YouTube) وX (Twitter) وMicrosoft & Outlook وSignal وDiscord وAmazon.

التوفر هدف متحرك، فابنِ مجموعات الاختبار بحيث تسأل الواجهة البرمجية أولاً. ويستطيع من هم خارج الهندسة أداء المهمة نفسها من لوحة التحكم: افتح حساباً برمز بريد إلكتروني أو تسجيل دخول Google، واشحن، واختر اليمن والخدمة، ثم انسخ رقم التحقق اليمني إلى التطبيق وانتظر الرمز في صفحة التفعيل.

لماذا قد لا يصل رمز يمني، وما الحل؟

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

الأسباب المعتادة والاستجابات:

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

استخدم هذه الأرقام لمنتجاتك وحساباتك المشروعة فقط، والتزم بشروط كل خدمة، وابقَ ضمن سياسة الاستخدام المقبول (Acceptable Use Policy) في OTP Route.

هل يمكنني الاحتفاظ برقم يمني طويل الأمد، وكيف يُحاسَب؟

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

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

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

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

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

ما سعر رمز التحقق +967؟

يبدأ من $0.20 للرمز ويختلف بحسب الخدمة؛ ويعيد GET /api/v1/prices الرقم الحي. والرموز التي لا تصل يُردّ مبلغها عند انتهاء نافذة الـ 20 دقيقة.

كيف أستخرج الرمز إذا كانت رسالة SMS تُقرأ من اليمين إلى اليسار؟

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

هل رقم +967 ملك لي لأحتفظ به؟

لا، رقم OTP Gateway يغطي تحققاً واحداً. والأرقام الدائمة منتج للولايات المتحدة وكندا؛ وبالنسبة لليمن راسل الدعم للسؤال.

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

نعم، اطلب sandbox لحساب تطوير. فهو يعيد أرقاماً ورموزاً محاكاة، وهذا يكفي لاختبار الاستعلام الدوري وwebhooks ومعالجة الأخطاء.

ما معرّف البلد الذي تستخدمه الواجهة البرمجية لليمن؟

هو ye. مرّره في استعلامات الأسعار وفي جسم JSON الخاص بـ POST /api/v1/activations.

لماذا رفضت خدمة رقمي اليمني؟

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

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