استقبال رموز التحقق +966 برمجيًا لإطلاقات المنتجات في السعودية

كيف يبدو تفعيل +966 واحد عبر API؟

نبدأ بالطلبات نفسها، فأغلب قراء هذه الصفحة يربطون واجهة SMS verification API بمجموعة اختبارات أو أداة داخلية. تقع كل نقاط النهاية تحت https://otproute.com/api/v1 وتتطلب مفتاح Bearer ببادئة or_live_ يُنشأ في وحدة تحكم المطورين (Developer console).

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

ويفيد GET /api/v1/balance كفحص تمهيدي حتى تفشل المهمة الليلية مبكرًا برسالة واضحة بدل أن تفشل في منتصف التشغيل. وهذه الحدود التي يجب أن تخطط لها: 10 مفاتيح و5 نقاط webhook لكل حساب، و300 طلب في الدقيقة.

كيف يجب أن يتعامل مستقبِل webhook لدينا مع أحداث OTP السعودية؟

سجّل نقطة نهاية واشترك في activation.sms_received وactivation.expired وactivation.cancelled. يتضمن كل طلب الترويسة X-OTPRoute-Signature بالصيغة t=<unix>,v1=<hex>.

• أعد بناء السلسلة الموقّعة بالشكل <t>.<raw body> واحسب HMAC-SHA256 بسر نقطة النهاية تلك.
• قارنها بالقيمة v1 بدالة زمن ثابت، وارفض أي طلب طابعه الزمني قديم جدًا.
• تعامل مع كل حدث على أنه مرتبط بمعرّف التفعيل، حتى لا تُحدِّث إعادة الإرسال شيئًا مرتين.
• أجب برمز 2xx سريعًا ونفّذ الأعمال البطيئة في مهمة خلفية.

يبقى الاستعلام الدوري بديلًا صالحًا للبيئات التي لا تقبل اتصالات واردة. وتتوسع مقالاتنا عن التقاط OTP عبر webhook وتأمين webhooks الخاصة برموز OTP عبر HMAC في الموضوع.

لماذا تختبر فرق المنتجات برقم +966؟

السعودية من أكبر الأسواق الرقمية في الخليج، ويصل الناس إلى هذه الصفحة لأسباب عملية: شركة تقنية مالية تجهّز مسار الانضمام لمقيمين في السعودية، أو سوق إلكتروني يضيف بائعين خليجيين، أو مزود SaaS يشترط عميله فحص تسجيل دخول إقليمي، أو فريق عمليات يدير حسابات أعمال لمكتب في الرياض أو جدة. وفي كل حالة يجب على أحدهم إثبات أن المسار يعمل برقم تحقق سعودي حقيقي، ويوفّر توجيه OTP عبر البوابة عناء شحن شرائح SIM إلى المنطقة. وتصف صفحة الانضمام في التقنية المالية هذا السيناريو بتفصيل أكبر.

ما الخدمات التي تستقبل الرموز على المسارات السعودية؟

تغطي اللقطة المباشرة للسعودية أكثر من 1,000 خدمة. ومن الخدمات الشائعة الاستخدام Snapchat وWhatsApp وX (Twitter) وUber وTikTok وInstagram وGoogle (Gmail & YouTube) وTelegram وAmazon وMicrosoft & Outlook وLinkedIn وDiscord وNetflix. ولدى Snapchat وX جمهور كبير في المملكة، ما يجعلهما بندين متكررين في قوائم فحص التوطين. المخزون يتحرك خلال اليوم، فاستعلم من API وقت التشغيل.

كيف أنسّق أرقام +966 وأحلّل الرسائل العربية؟

محليًا تُكتب أرقام الجوال السعودية بصفر الاتصال الداخلي، وغالبًا على الشكل 05 متبوعًا بثمانية أرقام. أما الصيغة الدولية فتحذف هذا الصفر: +966 5 والأرقام الثمانية المتبقية. وحّد كل شيء إلى صيغة E.164 عند الإدخال، واحذف الصفر إذا كتبه المستخدم بعد رمز الدولة.

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

هل هناك مسار من لوحة التحكم لمن لا يكتب الشيفرة؟

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

ماذا لو لم يصل الرمز، وماذا عن الخطوط طويلة الأمد والفوترة؟

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

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

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

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

كيف أستقبل رمز SMS سعوديًا عبر API؟

أنشئ تفعيلًا للدولة sa مع معرّف خدمتك، ثم خذ الرمز من webhook الحدث activation.sms_received أو بالاستعلام الدوري عن التفعيل.

هل أُحاسَب على رقم +966 للاختبار إذا فشل الرمز؟

لا. غياب الرمز يعني ردّ المبلغ كاملًا إلى المحفظة عند انتهاء مهلة 20 دقيقة أو عند الإلغاء.

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

نعم. يصدر OTP Gateway رقم +966 لرمز واحد، تدخله في تطبيقك وتقرأ الرمز عبر لوحة التحكم أو API.

كيف أخزّن رقم جوال سعوديًا أُدخل بالصيغة 05XXXXXXXX؟

احذف صفر الاتصال الداخلي وخزّنه بصيغة E.164 على الشكل +966 5 متبوعًا بالأرقام الثمانية المتبقية.

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

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

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

نعم. اطلب وضع sandbox على حساب تطوير لتحصل على أرقام ورموز محاكاة، بما فيها webhooks.

ما الاستخدامات التي يسمح بها OTP Route؟

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

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