رموز التحقق لبولندا (+48): قائمة فحص وخطوات API وحلول

قبل الانطلاق: ماذا أحتاج قبل اختبار التسجيل البولندي؟

اجتز هذه القائمة مرة واحدة، فيمرّ أول طلب بولندي عادةً دون مفاجآت:

1. بيانات الاعتماد. أنشئ مفتاح Bearer في وحدة تحكم المطورين (يبدأ بـ or_live_). تجعل المفاتيح المنفصلة للتجهيز وCI والإنتاج التدوير سهلًا.
2. المعرّفات. بولندا هي pl. اجلب معرّفات الخدمات من GET /api/v1/services بدل كتابة أسماء العرض يدويًا.
3. الرصيد. اشحن المحفظة؛ فكل سعر مرئي قبل أن تطلب.
4. وجهة التسليم. سجّل webhook عبر HTTPS وأبقِ سره خارج التحكم في الإصدارات. الاستعلام يعمل أيضًا إذا كانت الحركة الواردة محجوبة.
5. ميزانية الطلبات. يسمح API بـ 300 طلب في الدقيقة لكل حساب، فنظّم المجموعات المتوازية وفقًا لذلك.
6. النطاق. تحقق فقط من الحسابات التي تخص منتجك أو شركتك أو عميلك، والتزم بشروط كل خدمة إلى جانب سياسة الاستخدام المقبول لدينا.

وبالنسبة إلى خطوط الإنتاج تحديدًا، راجع اختبار SMS OTP في خطوط CI.

ما الخدمات التي ترسل رموزًا إلى أرقام +48 حاليًا؟

في توجيه OTP، تُعد بولندا من الإدخالات الأوسع في الكتالوج، إذ تغطي أكثر من 2,300 خدمة. تضم اللقطة الحالية للخدمات الشائعة Facebook وInstagram وTikTok وWhatsApp وTelegram وViber وSignal وSnapchat وDiscord وX (Twitter) وLinkedIn وGoogle (Gmail & YouTube) وAmazon وAliExpress وUber وNetflix.

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

ما الخطوات الدقيقة لاستخدام OTP API لبولندا؟

باستخدام واجهة التحقق عبر SMS على https://otproute.com/api/v1، ينفّذ الاختبار الآلي ما يلي:

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

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

هل يستطيع فريق العمليات طلب رقم بولندي دون API؟

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

ما الذي يجعل التعامل مع الأرقام والرسائل البولندية مختلفًا؟

تستخدم بولندا خطة ترقيم مغلقة دون بادئة اتصال محلي: كل رقم، جوالًا كان أو ثابتًا، يتكون من تسعة أرقام بعد +48. وهذا يجعل التحقق صارمًا بشكل مريح. ارفض المدخلات التي لا تختزل إلى تسعة أرقام وطنية، واحذف المسافات والشرطات التي يضيفها المستخدمون في مجموعات من ثلاثة، واحفظ +48 مع الأرقام التسعة كسلسلة E.164 واحدة. والصفر الزائد في البداية خطأ كتابي لا بادئة ينبغي الإبقاء عليها.

كثيرًا ما تصل رسائل التحقق بالبولندية عندما تكون لغة الحساب البولندية. وتقع أحرف مثل ą وę وł وż خارج أبجدية GSM ذات 7 بت، لذا إذا أرسلت نصوص OTP البولندية الخاصة بك فتوقع أجزاء أقصر واختبر القالب كما يظهر فعليًا على الهاتف. وعند تحليل الرموز الواردة، اعتمد على الأرقام وتجاهل الكلمات المحيطة بها.

من أسباب الاختبار هنا المعتادة: منتج يدخل السوق البولندي، واختبار توطين لمسارات بالبولندية، وفرق إقليمية ترعى حسابات أعمال في أنحاء وسط أوروبا، وتطبيقات يضم عملاؤها ناطقين بالبولندية يعيشون في مكان آخر من الاتحاد الأوروبي.

استكشاف الأخطاء: لماذا غاب رمز +48؟

• النافذة ما زالت مفتوحة. امنحها الـ 20 دقيقة كاملة قبل استخلاص أي نتيجة؛ فلا تُحاسَب إلا إذا وصل رمز.
• قد ترفض الخدمة الأرقام الافتراضية. بعض المنصات تفعل ذلك، وعندها يعيد الاسترداد التلقائي المبلغ كاملًا إلى المحفظة.
• المسار مزدحم. أعد المحاولة لاحقًا، أو جرّب مسار خدمة مختلفًا.
• الاختبار يدور في حلقة. إعادة الطلب كل بضع ثوانٍ تستنزف ميزانية طلباتك؛ أضف تراجعًا (backoff).

تجد المزيد من الأنماط مجموعة في تقليل إخفاقات تسليم OTP.

هل لدى بولندا أرقام مخصصة، وكيف تعمل المدفوعات؟

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

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

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

كيف أختبر مسار تسجيل بولندي إذا لم يكن لدى أحد في الفريق شريحة +48؟

اطلب رقم +48 للاختبار على OTP Gateway واستخدمه في المسار. يظهر الرمز في لوحة التحكم ويمكن إرساله إلى webhook لديك.

ما معرّف بولندا في استدعاءات OTP Route API؟

هو pl، ويُستخدم في POST /api/v1/activations وفي استعلام الأسعار معًا.

كم رقمًا في رقم الهاتف البولندي؟

تسعة أرقام وطنية بعد +48، دون صفر بادئ. هذا الطول الثابت يجعل التحقق من جهة الخادم مباشرًا.

كم تكلفة استلام رمز OTP عبر SMS من بولندا؟

تبدأ الأسعار من $0.20 لكل رمز وتختلف بحسب الخدمة. تعرض لوحة التحكم ونقطة نهاية الأسعار الرقم الدقيق قبل أن تطلب.

هل أخسر مالًا إذا انتهى تفعيل بولندي فارغًا؟

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

هل أستطيع محاكاة مسار بولندا كاملًا قبل الإطلاق؟

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

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