رقم لمرة واحدة أم خط طويل الأمد؟ اختيار مسار +1 787 لاختبارات التحقق

هل يستخدم مشروع بورتوريكو OTP Gateway أم رقمًا مخصصًا؟

ابدأ بمدة بقاء الرقم المطلوبة. تصدر OTP Gateway رقم +1 787 لرمز واحد فقط، وهو مناسب لاختبار تسجيل أو فحص توطين أو مهمة CI تتحقق مرة واحدة ثم تمضي. أما الرقم المخصص (Dedicated Number) فخط تحتفظ به، ويناسب حساب تجهيز (staging) يجب أن يسجّل الدخول مجددًا الأسبوع المقبل أو صندوق دعم مشتركًا.

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

ما استدعاءات API التي تنشئ تفعيلًا وتقرأه لبورتوريكو؟

يقع API على https://otproute.com/api/v1 ويتطلب مفاتيح Bearer تبدأ بـ or_live_. معرّف بورتوريكو هو pr.

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

تحمل استدعاءات webhook الترويسة X-OTPRoute-Signature: t=<unix>,v1=<hex>. أعد حساب HMAC-SHA256 للسلسلة <t>.<raw body> بسرّ النقطة، وقارن بمقارنة ثابتة الزمن، وارفض الطوابع الزمنية القديمة، وتجاهل الأحداث المكررة لمعرّف تفعيل عالجته من قبل. يحصل كل حساب على 10 مفاتيح و5 نقاط webhook و300 طلب في الدقيقة. ويتعمق دليل تكامل OTP API أكثر.

ما الذي يجعل أرقام +1 787 و+1 939 مربكة في النماذج؟

تنتمي بورتوريكو إلى خطة الترقيم لأمريكا الشمالية، فتبدو أرقامها كأي رقم أمريكي: رمز الدولة 1، ثم رمز منطقة من ثلاثة أرقام (787 أو الرمز المتراكب 939)، ثم سبعة أرقام، وتُكتب بصيغة E.164 على هيئة +1787 أو +1939 متبوعًا بسبعة أرقام.

هذا التشابه يسبب أخطاء حقيقية. بعض التطبيقات تعدّ بورتوريكو دولة مستقلة برمز ISO هو PR، وبعضها يدمجها في الولايات المتحدة، وقد تتوقع نماذج العناوين PR كقيمة ولاية. تأكد من أن منتقي الدولة ومدقق الهاتف وحقول العنوان متسقة فيما بينها، وأن المستخدم الذي يختار بورتوريكو لا يُقال له أبدًا إن رقمه +1 غير صالح. خزّن الأرقام بصيغة E.164 واستنتج المنطقة من رمز المنطقة لا من +1 في البداية.

ما الخدمات التي يمكنها استقبال رموز OTP عبر SMS لبورتوريكو؟

يضم مسار بورتوريكو حاليًا أكثر من 900 خدمة. من المرسلين الشائعين WhatsApp وUber وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وX (Twitter) وAmazon وChatGPT (OpenAI) وMicrosoft & Outlook وLinkedIn وDiscord وAirbnb وNetflix وTelegram. يتغير التوفر على مدار اليوم، فثق بإجابة API لحظة الطلب أكثر من أي قائمة.

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

ماذا لو لم يظهر الرمز خلال 20 دقيقة؟

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

إذا لم تصل الرموز البورتوريكية:

• امنح التفعيل نافذته الكاملة قبل أن تعدّ الاختبار فاشلًا.
• أعد المحاولة بعد قليل، أو اختر مسار خدمة مختلفًا.
• تأكد من أن الخدمة تقبل الأرقام الافتراضية؛ بعضها يرفضها، وقد وُجد الاسترداد لاستيعاب ذلك.
• لا تُطلق طلبات جديدة في حلقة سريعة؛ أضف تراجعًا أسيًّا (exponential backoff) بين المحاولات.

لمزيد من الأنماط، اقرأ تقليل إخفاقات تسليم OTP.

لماذا تتحقق الفرق من تدفقات الإسبانية والإنجليزية لبورتوريكو؟

الإسبانية والإنجليزية كلتاهما رسمية، والإسبانية هي اللغة التي يستخدمها معظم السكان يوميًا. هذا يجعل بورتوريكو مكانًا عمليًا لفحص التسجيل ثنائي اللغة: هل تصل رسالة التحقق بالإسبانية عندما يكون التطبيق مضبوطًا عليها، وهل تتعامل شاشة إدخال الرمز مع النص ذي العلامات الصوتية، وهل يُرسل القالب الصحيح عندما يبدّل المستخدم اللغة أثناء التدفق؟ وتستخدم الجزيرة الدولار الأمريكي وتخدمها شركات أمريكية كثيرة، لذا تحتاج تطبيقات الدفع ومنصات التوصيل والأسواق والمصارف التي توسّع إطلاقًا أمريكيًا غالبًا إلى رقم +1 787 للاختبار. أجرِ هذه الفحوص على حسابات تتحكم بها، والتزم بشروط كل خدمة، وابقَ ضمن سياسة الاستخدام المقبول لدى OTP Route. ولأتمتتها، راجع الاختبار في CI/CD.

كيف تعمل المحفظة وبيئة sandbox في اختبارات بورتوريكو؟

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

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

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

نعم. اطلب رقم +1 787 من OTP Gateway، وأدخله في تطبيقك، واستلم الرمز في لوحة التحكم أو عبر API التحقق بـ SMS وwebhooks.

هل تُعامل بورتوريكو كالولايات المتحدة في API؟

لا. لها معرّف دولة خاص بها هو pr، تستخدمه في استعلامات الأسعار وطلبات التفعيل بدل معرّف الولايات المتحدة.

هل يمكنني شراء رقم مخصص +1 787؟

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

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

يعتمد ذلك على المرسِل، وغالبًا على إعداد لغة التطبيق. إن كان منتجك يدعم اللغتين، فاختبر الإعدادين الإسباني والإنجليزي.

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

تستخدم بورتوريكو 787 و939. وأيًّا كان ما تستلمه، خزّنه بصيغة E.164 لتبقى سجلاتك متسقة.

كم يكلف رمز تحقق بورتوريكي؟

من $0.20 للرمز. يأتي السعر الدقيق لكل خدمة من GET /api/v1/prices ومن لوحة التحكم، ولا يُحتسب أي مبلغ إذا لم يصل الرمز.

كم اختبارًا متوازيًا يمكنني تشغيله؟

يتيح الحساب 300 طلب في الدقيقة و10 مفاتيح. ويذهب معظم هذه الميزانية إلى الاستعلام الدوري، لذا تترك webhooks مساحة أوسع للمهام المتوازية.

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