العربية
التقاط رموز التحقق البنمية عبر SMS برمجيًا، خطوة بخطوة
يتيح لك OTP Route استلام رموز التحقق عبر SMS لبنما (+507) من خلال واجهة OTP Gateway، ويُسلَّم كل رمز إلى webhook موقّع أو يُعاد بالاستعلام، مع توفر الطلبات نفسها في لوحة التحكم. تبدأ الأرقام من $0.20 لكل رمز، ويُحجز كل رقم 20 دقيقة لرمز واحد، ويعود المال إلى محفظتك إذا لم تصل أي رسالة SMS.
ما نقاط النهاية التي أستدعيها للحصول على رمز +507؟
كل شيء تحت https://otproute.com/api/v1 ويُصادَق بمفتاح Bearer يبدأ بـ or_live_. معرّف بنما هو pa. هكذا يبدو تشغيل معتاد لحالة اختبار:
GET /api/v1/prices?country=pa&service=whatsappيعيد السعر المباشر لهذا الزوج، ليتوقف مشغّلك إذا تجاوز ميزانية حددتها.POST /api/v1/activationsمع{"service": "whatsapp", "country": "pa"}يحجز رقمًا ويعيد معرّف التفعيل.- يدخل اختبارك الرقم في شاشة التسجيل ويطلق رسالة SMS.
- يصلك الرمز عبر حدث webhook أو عبر
GET /api/v1/activations/{id}. POST /api/v1/activations/{id}/cancelينهي التشغيل مبكرًا ويسترد قيمته.
استخدم GET /api/v1/balance قبل مجموعة كبيرة حتى لا يظهر نفاد المحفظة على شكل موجة من حالات الفشل الكاذبة. وتسرد نظرة المطورين العامة ومرجع API الكامل تفاصيل الطلبات والاستجابات.
هل أعتمد على webhooks أم الاستعلام لمسارات بنما؟
webhooks هي الخيار الأنظف لتكامل OTP API لبنما. سجّل نقطة نهاية (حتى 5 لكل حساب) واشترك في activation.sms_received وactivation.expired وactivation.cancelled. يحمل كل طلب الترويسة X-OTPRoute-Signature: t=<unix>,v1=<hex>؛ أعد بناء HMAC-SHA256 لـ "<t>.<raw body>" بسر نقطة النهاية، وقارن بزمن ثابت، وأسقط أي طلب بطابع زمني قديم. اربط المعالج بمعرّف التفعيل حتى لا يعالج تسليم معاد المحاولة الرمز نفسه مرتين.
الاستعلام يناسب السكربتات القصيرة أو الشبكات التي لا تقبل الاستدعاءات الواردة. باعد بين الطلبات؛ فحد الحساب هو 300 طلب في الدقيقة مشتركة بين ما يصل إلى 10 مفاتيح، وحلقة سريعة على تفعيل واحد تهدر هذه الميزانية. المزيد من الأنماط في مقالنا عن التقاط OTP عبر webhook.
ماذا ينبغي أن تعرف شيفرتي عن أرقام الهاتف البنمية؟
لا توجد في بنما بادئة اتصال محلي، لذا تأتي الأرقام الوطنية بعد +507 كما هي. أرقام الجوال من ثمانية أرقام وتبدأ بـ 6، بينما الخطوط الأرضية من سبعة أرقام، وهو أمر مهم إذا كان مدقّقك يفرض طولًا واحدًا للبلد كله.
- احفظ الأرقام بصيغة E.164، مثلًا
+5076يليها سبعة أرقام أخرى للجوال. - اقبل شرطة بعد الرقم الرابع عند الإدخال، لأنها طريقة محلية شائعة لكتابة الجوال، ثم احذفها قبل الحفظ.
- ارفض إدخال سبعة أرقام في المسارات المعتمدة على SMS فقط، لأنه على الأرجح خط أرضي لا يستقبل الرمز.
الإسبانية هي اللغة الرسمية، لذا تصل نصوص التحقق عادةً بالإسبانية عندما يوطّن التطبيق بحسب المنطقة أو لغة الحساب. تأكد من أن قالب رسالتك وعدد الأحرف وأي تعبير نمطي لاستخراج الرمز يتعامل مع الأحرف ذات التشكيل.
لماذا تختبر الفرق أو تعمل في بنما أصلًا؟
القناة وتجارة الشحن واللوجستيات وقطاع الخدمات الدولية الكبير تجعل بنما مقرًا إقليميًا شائعًا لتغطية أمريكا الوسطى ومنطقة الكاريبي. وكثيرًا ما تبدأ فرق المنتج التي تطلق تطبيقًا بالإسبانية في المنطقة اختبار التوطين من هنا، وتحتاج فرق العمليات المقيمة في أماكن أخرى إلى إثبات أن العملاء ذوي أرقام +507 قادرون على إكمال التسجيل.
ويتيح رقم تحقق بنمي من OTP Gateway لهم ذلك من أي مكتب. وعندما لا يتطلب الاختبار بنما تحديدًا، يمكن لمسارات قريبة مثل كوستاريكا أو كولومبيا أن تكون مقارنة مفيدة لسلوك توجيه الدول.
ما الخدمات التي تستقبل الرموز على مسار بنما؟
تسرد لقطة اليوم WhatsApp وTelegram وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وX (Twitter) وChatGPT (OpenAI) وClaude وMicrosoft & Outlook وAmazon وUber وeBay وAirbnb وNetflix. ويضم المسار حاليًا أكثر من 1,000 خدمة إجمالًا. يتغير المخزون خلال اليوم، لذا اقرأ دائمًا GET /api/v1/services أو لوحة التحكم بدل كتابة قائمة ثابتة.
يحصل غير المطورين على التغطية نفسها في المتصفح: أنشئ حسابًا، وأضف رصيدًا، واختر الخدمة وبنما، وأكّد السعر المعروض، وانسخ الرقم إلى التطبيق وانتظر ظهور الرمز بجانب الطلب.
كيف أتعامل مع رقم بنمي لا يستقبل شيئًا؟
نافذة الـ 20 دقيقة شبكة أمانك: لا تُحاسَب إلا عند وصول رمز، ويسترد التفعيل المنتهي أو الملغى المبلغ كاملًا تلقائيًا. عندما يظل الرقم صامتًا:
- دعه يصل إلى الانتهاء بدل الإلغاء وإعادة الطلب خلال ثوانٍ؛ فالحلقات المتلاحقة تبدو مريبة للخدمة المُرسِلة.
- أعد المحاولة بعد مهلة، أو جرّب مسار خدمة آخر.
- تأكد من أن الخدمة تقبل الأرقام الافتراضية؛ فبعضها يرفضها تمامًا، والاسترداد موجود لهذه الحالة.
- سجّل الحدث
activation.expiredحتى تكون التشغيلات غير المستقرة ظاهرة لا صامتة.
هذه الأرقام مخصصة لاختبار حساباتك المشروعة وتشغيلها. التزم بشروط كل خدمة مُرسِلة، وتذكّر أن سياسة الاستخدام المقبول في OTP Route تحكم كل طلب.
ماذا عن الخطوط البنمية طويلة الأمد والفوترة واختبار sandbox؟
لا يبيع OTP Route رقمًا بنميًا طويل الأمد بالخدمة الذاتية. الأرقام المخصصة (Dedicated Numbers) مقصورة على الولايات المتحدة وكندا، بدءًا من $1.95/month؛ وللحصول على خط بنمي راسل [email protected] وسيخبرك الفريق ما إذا كانت اللوائح المحلية تسمح بشيء.
تتم المدفوعات عبر محفظة USD واحدة مسبقة الدفع دون رسوم شهرية أو خطة، وتُشحن بالبطاقة أو USDT/USDC، وتصلك فاتورة PDF بالبريد عن كل عملية شحن. يمكن نقل حساب التطوير إلى sandbox عند الطلب، فيعيد أرقامًا ورموزًا محاكاة ليُختبر المسار كاملًا دون المساس برصيد المحفظة. راجع الأسعار للاطلاع على الأسعار المباشرة.
الأسئلة الشائعة
هل أستطيع أتمتة التحقق عبر SMS لبنما في خط CI لدي؟
نعم. أنشئ تفعيلات بالدولة pa عبر REST API واستهلك الرمز من webhook موقّع أو بالاستعلام عن التفعيل.
كم طول أرقام الجوال البنمية؟
أرقام الجوال من ثمانية أرقام تبدأ بـ 6، وتُكتب بعد +507، ولا توجد بادئة اتصال محلي لحذفها.
كم تكلفة استلام رمز OTP عبر SMS من بنما؟
من $0.20 لكل رمز؛ وتعيد نقطة نهاية الأسعار في API المبلغ الدقيق لكل خدمة قبل أن تطلب.
هل يُخصم من محفظتي إذا لم يصل الرمز؟
لا. دون رسالة SMS داخل نافذة الـ 20 دقيقة، أو بعد الإلغاء، يُسترد المبلغ تلقائيًا.
هل ستكون رسائل التحقق في بنما بالإسبانية؟
عادةً نعم، إذا وطّن التطبيق بحسب المنطقة أو لغة الحساب، فتأكد من أن منطق التحليل لديك يتعامل مع النص الإسباني.
هل أستطيع اختبار مسار التسجيل في بنما دون شريحة محلية؟
نعم. رقم +507 من OTP Gateway يغطي رمزًا واحدًا في كل مرة، فلا يحتاج فريقك إلى هاتف بنمي أبدًا.
هل أستطيع شراء رقم +507 دائم؟
ليس بالخدمة الذاتية. الأرقام المخصصة طويلة الأمد منتج للولايات المتحدة وكندا؛ راسل [email protected] للاستفسار عن بنما.
أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.