مسار المطوّر إلى رموز التحقق الأردنية (+962)

كيف يبدو تسلسل الطلبات لرقم +962؟

واجهة التحقق عبر SMS هي REST بسيطة على https://otproute.com/api/v1، بمفاتيح Bearer ببادئة or_live_ تنشئها في وحدة تحكم المطورين. وهذا هو الترتيب الذي تتبعه معظم التكاملات للأردن:

1. الاستكشاف: يعيد GET /api/v1/services وGET /api/v1/countries المعرّفات. الأردن هو jo؛ وخدمة مثل Telegram هي telegram.
2. فحص السعر: يعيد GET /api/v1/prices?country=jo&service=telegram ما يكلّفه هذا الزوج الآن وهل يمكن طلبه.
3. الطلب: يحجز POST /api/v1/activations مع {"service": "telegram", "country": "jo"} رقمًا ويعيد معرّف التفعيل.
4. الجمع: استعلم دوريًا عن GET /api/v1/activations/{id} كل بضع ثوانٍ، أو دع webhook يدفع النتيجة إليك.
5. التنظيف: يحرر POST /api/v1/activations/{id}/cancel تفعيلًا لم تعد بحاجة إليه ويرد قيمته.

ويفيد GET /api/v1/balance كحارس في بداية تشغيل الاختبار، فتفشل المهمة مبكرًا برسالة واضحة حين تكون المحفظة منخفضة. المرجع الكامل في التوثيق.

كيف أتأكد أن webhook جاء فعلًا من OTP Route؟

يصل كل حدث (مثل activation.sms_received أو activation.expired) مع ترويسة X-OTPRoute-Signature بصيغة t=<unix>,v1=<hex>. يحسب خادمك HMAC-SHA256 للنص "<t>.<raw body>" بسرّ نقطة النهاية تلك، ويقارن النتيجة بـ v1. ارفض الطلب إذا اختلفت القيمتان أو إذا كان t بعيدًا في الماضي؛ فهذا يمنع إعادة التشغيل.

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

أي التطبيقات يمكن التحقق منها على مسار الأردن؟

تُدرج للأردن أكثر من 1,700 خدمة. ومن الخدمات الشائعة WhatsApp وTelegram وFacebook وInstagram وSnapchat وTikTok وX (Twitter) وDiscord وClaude وMicrosoft & Outlook وAmazon وViber وimo وSignal وLinkedIn.

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

تنسيق الأرقام الأردنية: صفر البادئة وE.164 والنص العربي

رمز دولة الأردن هو +962 وبادئته المحلية 0. محليًا يُكتب رقم الجوال بادئًا بـ 07؛ وفي الصيغة الدولية يختفي الصفر، ويبقى +962 متبوعًا بتسعة أرقام تبدأ بـ 7. خزّن صيغة E.164، وحين يلصق المستخدمون رقمًا محليًا فاحذف الصفر الأول قبل إضافة رمز الدولة. ومقارنة 07… بـ +9627… كسلاسل نصية سبب كلاسيكي لأخطاء الحسابات المكررة.

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

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

طلب رمز أردني من لوحة التحكم

يستطيع موظفو العمليات فعل الأمر نفسه دون كتابة شيفرة. أنشئ حسابًا ببريد إلكتروني ورمز من ست خانات أو بتسجيل الدخول عبر Google، وأضف رصيدًا، واختر الأردن والخدمة في OTP Gateway، وأكّد السعر المعروض وأرسل الطلب. يظهر الرقم +962 فورًا، ويظهر الرمز بجانبه حين تصل الرسالة.

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

ترتيب لتصحيح أخطاء الرموز التي لا تصل

ابدأ بأرخص تفسير وتوسّع تدريجيًا:

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

اختبر الحسابات التي تملكها أو تشغّلها فقط، والتزم بقواعد كل خدمة، وتذكّر أن سياسة الاستخدام المقبول في OTP Route تغطي كل استخدام.

الخطوط طويلة الأمد والمحفظة وsandbox

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

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

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

ما رمز الدولة الخاص بالأردن في API؟

استخدم jo قيمةً للحقل country في API الخاصة بـ OTP Route، مثلًا في GET /api/v1/prices?country=jo&service=whatsapp.

هل أحذف الصفر من رقم جوال أردني؟

نعم، للصيغة الدولية. يصبح الرقم المحلي 07 هو +962 متبوعًا بتسعة أرقام تبدأ بـ 7.

هل سيصل رمز التحقق الأردني بالعربية؟

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

كم مدة الاحتفاظ برقم +962 لاستقبال الرمز؟

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

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

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

هل هناك طريقة لاستقبال رموز OTP الأردنية في الاختبارات الآلية؟

نعم. اطلب عبر POST /api/v1/activations، ثم استعلم دوريًا عن التفعيل أو عالج webhook الموقّع؛ ويتيح لك حساب sandbox التدرب على ذلك برموز محاكاة.

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