رموز التحقق لباراغواي (+595)، بدءًا من API

كيف أطلب رقم +595 برمجيًا؟

ابدأ من وحدة تحكم المطورين وأنشئ مفتاح Bearer؛ تبدأ المفاتيح بـ or_live_ ويمكنك الاحتفاظ بما يصل إلى 10، ما يسهّل استخدام مفاتيح منفصلة للتجهيز وCI. تذهب كل الطلبات إلى https://otproute.com/api/v1.

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

يفيد GET /api/v1/balance كخطوة فحص مسبق في خط الإنتاج، فتفشل المهمة بوضوح عند فراغ المحفظة بدل انتهاء المهلة. ويشرح دليل التكامل الاستدعاءات نفسها مع سياق أوسع.

ماذا ينبغي أن يفعل معالج webhook برمز باراغواي؟

تتلقى نقطة نهايتك activation.sms_received عندما تصل الرسالة، وactivation.expired عندما تنتهي النافذة فارغة، وactivation.cancelled بعد الإلغاء. ويرتبط كل منها بمعرّف التفعيل.

• تحقق أولًا. قسّم X-OTPRoute-Signature إلى t وv1، واحسب HMAC-SHA256 للطابع الزمني ثم نقطة ثم جسم الطلب الخام بسر نقطة النهاية، وقارن بزمن ثابت.
• ارفض الطلبات القديمة. طابع زمني بعيد عن ساعتك يعني إعادة تشغيل (replay) أو خادمًا بساعة منحرفة كثيرًا.
• كن idempotent. خزّن معرّف التفعيل وتجاهل التكرارات، حتى لا يعالج تسليم معاد المحاولة الرمز مرتين.

يُسمح بما يصل إلى 5 نقاط نهاية webhook لكل حساب. وإذا فضّلت الاستعلام فاجعل الفاصل معتدلًا؛ فالحد هو 300 طلب في الدقيقة على مستوى الحساب. ويضم دليل HMAC لـ webhook قائمة تحقق أوسع.

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

تقدّم باراغواي حاليًا أكثر من 1,600 خدمة. من أكثرها طلبًا WhatsApp وInstagram وTelegram وUber وFacebook وTikTok وGoogle (Gmail & YouTube) وMicrosoft & Outlook وX (Twitter) وDiscord وLinkedIn وNetflix وChatGPT (OpenAI). يُعد WhatsApp تطبيق المراسلة اليومي لكثيرين في المنطقة، لذا يكون غالبًا أول خدمة تتحقق منها الفرق عند اختبار الدعم القائم على الدردشة.

كيف تُكتب أرقام الجوال +595 وكيف تُوحَّد؟

تستخدم باراغواي بادئة اتصال محلي 0 للاتصال الداخلي، لذا يبدأ رقم الجوال المرئي محليًا بـ 09. وفي صيغة E.164 يزول هذا الصفر: الصيغة المعيارية هي +595 يليها تسعة أرقام، وتبدأ أرقام الجوال بـ 9. وحّد الصيغة عند الإدخال، واحفظ صيغة E.164 فقط، ونسّق للعرض عند الواجهة. وقواعد التحقق التي تتوقع طولًا ثابتًا من بلد آخر سبب شائع لفشل تسجيل المستخدمين الباراغوانيين، فأدرج رقم +595 في حالات اختبار التحقق لديك.

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

لماذا تتحقق الفرق من حسابات في باراغواي؟

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

هل توجد طريقة دون كتابة شيفرة للحصول على رقم تحقق باراغواي؟

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

ما الذي يفيد عندما لا يظهر رمز +595؟

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

هل أستطيع الاحتفاظ برقم باراغواي طويل الأمد، وكيف تُدار الفوترة؟

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

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

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

ما معرّف باراغواي في OTP Route API؟

هو py. استخدمه في استعلام الأسعار وفي جسم POST /api/v1/activations.

هل أخزّن الأرقام الباراغوانية بالبادئة 09؟

لا. احذف الصفر المحلي واحفظ +595 يليه الرقم الوطني من تسعة أرقام.

كم تكلفة رقم +595 للاختبار؟

يبدأ تفعيل باراغواي من $0.20 لكل رمز بحسب الخدمة، ولا يُخصم من المحفظة إلا عن رمز وصل فعلًا.

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

نعم. اطلب رقم تحقق باراغواي على OTP Gateway واقرأ الرمز في لوحة التحكم أو عبر API.

هل ستصل الرموز بالغوارانية؟

نادرًا، إن حدث أصلًا. ترسل الخدمات الدولية عادةً نصًا بالإسبانية أو الإنجليزية، لذا حلّل الأرقام فقط.

ماذا يحدث لأموالي إذا انتهى التفعيل؟

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

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