رموز تحقق برمجية على +351 لإطلاق منتجاتك في البرتغال

ما نقاط النهاية التي تمرّ بها عملية تحقق +351؟

عنوان الأساس هو https://otproute.com/api/v1، وكل طلب يحمل مفتاح Bearer يبدأ بـ or_live_. معرّف البرتغال هو pt.

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

حدود الحساب هي 10 مفاتيح API و5 نقاط webhook و300 طلب في الدقيقة. تجد المخططات الكاملة في مرجع API.

كيف تسلّم webhooks الموقّعة الرموز البرتغالية إلى خدمتنا؟

سجّل نقطة HTTPS في وحدة تحكم المطورين (Developer console) واشترك في activation.sms_received وactivation.expired وactivation.cancelled. يتضمن كل طلب POST الترويسة X-OTPRoute-Signature: t=<unix>,v1=<hex>.

للتحقق منها، أعد بناء السلسلة <t>.<raw body> واحسب HMAC-SHA256 بسرّ النقطة، ثم قارنها بقيمة v1 بمقارنة ثابتة الزمن. ارفض الطلبات التي طابعها الزمني قديم حتى لا يمكن إعادة تشغيل طلب تم التقاطه. احفظ معرّف التفعيل من كل حدث وتجاهل أي تكرار، فيصبح المعالج آمنًا عند إعادة محاولات التسليم. يشرح الالتقاط عبر webhook هذا النمط خطوة بخطوة.

ما الخدمات المفتوحة على المسارات البرتغالية؟

تُظهر البرتغال أكثر من 2,000 خدمة في اللقطة الحالية. من الخدمات الشائعة الاستخدام WhatsApp وTelegram وAirbnb وUber وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وLinkedIn وMicrosoft & Outlook وAmazon وNetflix وDiscord وSignal.

تتغير هذه المجموعة على مدار اليوم مع تبدّل سعة شركاء الاتصالات لدينا. لهذا ينبغي أن تقرر نقطة الأسعار، لا ملف إعداد ثابت، ما إذا كان الاختبار سيُشغَّل.

لماذا تختبر فرق المنتج مع أرقام برتغالية؟

كثيرًا ما تظهر البرتغال مبكرًا في خطط التوسع الأوروبي. تستضيف لشبونة وبورتو فرقًا كثيرة للمنتج والهندسة، وتتخذ شركات عديدة من البرتغال قاعدة لها في أوروبا. وهناك سبب يتعلق بالتوطين أيضًا: البرتغالية الأوروبية (pt-PT) تختلف عن البرتغالية البرازيلية في الإملاء والمفردات وصيغ المخاطبة، فقد يبدو تدفق مترجم للبرازيل غريبًا لمن يقيم في البرتغال. وتشغيل تحقق حقيقي على +351 يتيح للمراجعين رؤية نصوص pt-PT والرسالة الواصلة والشاشات المحيطة بها معًا.

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

كيف تُنسَّق أرقام +351 وتُخزَّن؟

لا توجد في البرتغال بادئة وطنية (trunk prefix): الأرقام من تسعة أرقام وتُطلب بالطريقة نفسها محليًا وبالصيغة الدولية بعد +351. تبدأ أرقام الجوال بالرقم 9، بينما تبدأ الخطوط الأرضية الجغرافية بالرقم 2. خزّنها بصيغة E.164، وارفض أي رقم لا يتكون من تسعة أرقام بعد رمز الدولة، وأزل المسافات التي يضيفها المستخدمون عند كتابة مجموعات من ثلاثة أرقام.

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

هل يستطيع زميل تنفيذ ذلك دون كتابة شيفرة، وماذا لو لم تصل رسالة؟

في لوحة التحكم، افتح OTP Gateway واختر البرتغال وخدمة، وتحقق من السعر الحالي، ثم اطلب الرقم. الصق الرقم في تطبيقك وانتظر الرمز في صفحة التفعيل.

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

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

هل يوجد خط برتغالي مخصص، وكيف تعمل الفوترة؟

لا تبيع OTP Route أرقامًا مخصصة ذاتية الخدمة في البرتغال. الأرقام الافتراضية المخصصة (Dedicated Virtual Numbers) متاحة فقط في الولايات المتحدة وكندا، بدءًا من $1.95/شهريًا؛ وللحصول على خط +351 طويل الأمد، راسل [email protected] مع العلم أن التوفر يعتمد على القواعد المحلية وليس مضمونًا. اطّلع على الفرق بين الأرقام المؤقتة والمخصصة.

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

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

ما معرّف دولة البرتغال في API الخاص بـ OTP Route؟

هو pt، ويُستخدم في استعلام الأسعار وفي جسم طلب التفعيل.

هل تستخدم الأرقام البرتغالية بادئة وطنية مثل 0 في البداية؟

لا. الأرقام البرتغالية من تسعة أرقام دون بادئة وطنية، لذا تكون صيغة E.164 هي +351 متبوعة بهذه الأرقام التسعة.

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

نعم. يستقبل رقم +351 للاختبار من OTP Gateway الرمز، وتقرؤه في لوحة التحكم أو عبر API.

كم يكلف رقم تحقق برتغالي؟

من $0.20 للرمز؛ ويعتمد السعر الدقيق على الخدمة ويظهر قبل الطلب.

هل سأدفع مقابل تفعيل +351 لم يستقبل شيئًا؟

لا. تُردّ التفعيلات المنتهية أو الملغاة بالكامل إلى محفظتك.

هل يمكنني استئجار رقم برتغالي لعمليات تسجيل دخول متكررة؟

ليس ذاتيًا. الخطوط طويلة الأمد منتج للولايات المتحدة وكندا؛ راسل الدعم إن احتجت خط +351.

هل أستخدم الاستعلام الدوري أم webhooks للرموز البرتغالية؟

تتوسع webhooks بشكل أفضل مع المهام المتوازية، بينما يناسب الاستعلام الدوري عبر GET /api/v1/activations/{id} المشغّلات التي لا تستطيع قبول حركة واردة.

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