جلب رموز التحقق الأرجنتينية (+54) إلى تكاملك

ما استدعاءات API الأربعة وراء تفعيل +54؟

كل شيء تحت https://otproute.com/api/v1 ويُصادَق بمفتاح Bearer يبدأ بـ or_live_. تُصدَر المفاتيح في وحدة تحكم المطورين؛ ويمكن للحساب أن يضم حتى 10 منها وأن يسجّل 5 نقاط ويب هوك، بحدّ أقصى 300 طلب في الدقيقة.

1. اطلب السعر. استدعِ GET /api/v1/prices?country=ar&service=<id> ليعرف كودك التكلفة الحية قبل الالتزام بأموال المحفظة. معرّف الأرجنتين هو ar.
2. اطلب الرقم. أرسل POST /api/v1/activations بجسم JSON هو {"service": "whatsapp", "country": "ar"}، مع استبدال معرّف الخدمة الذي يحتاجه اختبارك. تحمل الاستجابة معرّف التفعيل ورقم +54 الذي تكتبه في التطبيق قيد الاختبار.
3. انتظر الرمز. إما أن تقرأ GET /api/v1/activations/{id} بفاصل زمني معقول، أو تدع ويب هوك activation.sms_received تخبرك بوصول الرمز.
4. حرّره مبكرًا عند الحاجة. يُنهي POST /api/v1/activations/{id}/cancel تفعيلًا لم تعد تريده ويعيد المال إلى المحفظة.

وإن أردت رؤية المعرّفات قبل تثبيتها في الكود، فإن GET /api/v1/services وGET /api/v1/countries يسردان ما تقدمه المنصة حاليًا. ويوجد المرجع الكامل في الوثائق.

كيف أجعل مستقبِل الويب هوك موثوقًا لرموز الأرجنتين؟

يتضمن كل تسليم ترويسة X-OTPRoute-Signature بصيغة t=<unix>,v1=<hex>. أعد بناء السلسلة "<t>.<raw body>"، واحسب HMAC-SHA256 عليها بسر نقطة النهاية تلك، وقارن الناتج بـ v1 باستخدام دالة بزمن ثابت. أسقط أي طلب طابعه الزمني قديم، فالتوقيع القديم الصالح هو بالضبط ما يبدو عليه هجوم إعادة التشغيل.

وإلى جانب activation.sms_received اشترك في activation.expired وactivation.cancelled حتى لا يعلق مشغّل الاختبارات في انتظار رقم أُغلق بالفعل. تعامل مع كل حدث على أنه مرتبط بمعرّف التفعيل، واكتب معالجك بحيث لا يغيّر تسليم ثانٍ للحدث نفسه شيئًا. ويشرح المقال عن توقيع ويب هوك OTP والتحقق منها منطق المقارنة بمزيد من العمق.

أي التطبيقات أستطيع التحقق منها برقم أرجنتيني؟

تسرد اللقطة الحية للأرجنتين أكثر من 2,000 خدمة. ومن التي تلجأ إليها فرق المنتج والجودة الأرجنتينية عادةً:

• المراسلة: WhatsApp وTelegram وSignal وDiscord
• الحسابات والإنتاجية: Google (Gmail وYouTube) وMicrosoft وOutlook وLinkedIn وChatGPT (OpenAI)
• التواصل الاجتماعي والفيديو: Instagram وTikTok
• التجارة والتنقل: Amazon وUber وAirbnb وNetflix

تتغير هذه القائمة خلال اليوم، ولهذا يُبلغ API عن التوفر مباشرةً بدل جدول ثابت. استعلم عبر GET /api/v1/services مع وضع دولة ar في الاعتبار قبل بدء مهمة CI مجدولة، وأفشِل التشغيل سريعًا برسالة واضحة إن كانت خدمتك المستهدفة غير متاحة مؤقتًا.

لماذا تربك أرقام الجوال الأرجنتينية أدوات التحقق من الهاتف؟

للأرجنتين واحدة من أغرب خطط الترقيم في المنطقة. محليًا يكتب الناس بادئة 0 قبل رمز المنطقة، وللجوالات 15 قبل أرقام المشترك، فقد يظهر جوال في بوينس آيرس على هيئة 011 15 متبوعًا بثمانية أرقام. وفي الصيغة الدولية E.164 يختفي الاثنان ويُدرَج الرقم 9 مباشرةً بعد رمز الدولة: +54 9 11 ثم رقم المشترك المكوّن من ثمانية أرقام.

هذا الفرق مهم لكل من يخزّن أرقام الهاتف. وحّد كل شيء إلى E.164 قبل الحفظ، واحذف الـ 0 والـ 15 عند الإدخال، وأضف الـ 9 لأرقام الجوال. فأداة تحقق تفحص الطول فقط ستقبل بسرور قيمة +54 11 بنمط الخط الأرضي لا يمكنها استقبال الرسائل. استخدم الرقم تمامًا كما يُعيده API بدل إعادة تنسيقه بنفسك.

عادةً ما تصل الرموز المرسلة إلى الأرقام الأرجنتينية بالإسبانية، وغالبًا بعبارة مثل "Tu código es" حول الأرقام. حلّل الرمز الرقمي بنمط بدل مطابقة الصياغة، لأن القوالب تتغير. وتختبر الفرق هنا عند الإطلاق في أمريكا اللاتينية، أو مراجعة نصوص الإسبانية الريوبلاتنسية (فصيغ vos المحلية تختلف عن الإسبانية المعيارية)، أو إدارة العمليات الإقليمية، أو خدمة الأرجنتينيين المقيمين في الخارج الذين ما زالوا يسجلون بشريحة +54.

هل يستطيع من لا يكتب الكود طلب رقم +54؟

نعم. يستطيع موظفو الدعم والنمو والوكالات إنجاز كل شيء من المتصفح:

1. أنشئ حسابًا في صفحة التسجيل ببريد إلكتروني ورمز من 6 أرقام، أو عبر تسجيل الدخول بـ Google.
2. أضف رصيدًا إلى المحفظة.
3. افتح OTP Gateway، واختر الأرجنتين، ثم اختر الخدمة التي تختبرها.
4. تحقق من السعر المعروض، وأكّد، وانسخ رقم +54 إلى شاشة التحقق في التطبيق.
5. راقب التفعيل؛ يظهر الرمز هناك بمجرد استلامه.

تعتمد لوحة التحكم وAPI على المحفظة نفسها والتفعيلات نفسها، لذا يستطيع المطوّر أن يتسلّم رقمًا طلبه زميله عبر معرّف التفعيل.

لم يظهر الرمز الأرجنتيني. ماذا بعد؟

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

ثم جرّب هذه القائمة القصيرة:

• اطلب الرمز مرة واحدة من داخل التطبيق، ثم دع النافذة تعمل.
• جرّب لاحقًا في اليوم، أو اطلب عبر مسار آخر للخدمة نفسها.
• تأكد من أن الخدمة تقبل الأرقام الافتراضية أصلًا؛ فبعضها يرفضها، وهذا سبب وجود الاسترداد التلقائي.
• تجنّب إعادة الطلب في حلقة سريعة من CI. أضف تأخيرًا متزايدًا وحدًّا لعدد المحاولات.

ويغطي مقالنا عن تقليل إخفاقات تسليم OTP أنماطًا إضافية للمسارات الأرجنتينية. أبقِ كل اختبار ضمن شروط كل خدمة؛ كما تنطبق سياسة الاستخدام المقبول الخاصة بـ OTP Route.

هل يمكننا الاحتفاظ بخط أرجنتيني، وكيف ندفع؟

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

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

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

ما معرّف دولة الأرجنتين في OTP Route API؟

هو ar. مرّره في الحقل country ضمن POST /api/v1/activations وفي سلسلة الاستعلام لـ GET /api/v1/prices.

هل أحتاج إلى إضافة الرقم 9 عند كتابة رقم +54 في تطبيق؟

استخدم الرقم تمامًا كما يُعيده OTP Route. وفي قاعدة بياناتك خزّن الجوالات الأرجنتينية بصيغة E.164، التي تتضمن الـ 9 بعد +54 وتحذف الـ 0 والـ 15 المحليين.

كم تبلغ تكلفة استقبال رمز OTP نصي من الأرجنتين؟

من $0.20 للرمز، وتختلف حسب الخدمة. يُعيد GET /api/v1/prices الرقم الدقيق ويُعرض قبل أن تؤكد الطلب.

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

نعم. اطلب تفعيلًا للأرجنتين لتطبيقك أو للخدمة الخارجية في اختبارك، وأدخل رقم +54، واقرأ الرمز في لوحة التحكم أو من الويب هوك.

هل يعمل رقم +54 نفسه مرة أخرى لتسجيل دخول الشهر القادم؟

لا. يغطي رقم البوابة رمزًا واحدًا خلال 20 دقيقة. وللحسابات التي يجب أن تواصل استقبال الرموز، فالخيار المناسب هو رقم مخصص في الولايات المتحدة أو كندا.

بأي لغة ستكون رسالة التحقق الأرجنتينية؟

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

هل يُقبل الاستعلام الدوري بدلًا من الويب هوك؟

نعم. استعلم عن GET /api/v1/activations/{id} بفاصل زمني معتدل وابقَ دون حدّ 300 طلب في الدقيقة لكل حساب بمسافة كافية.

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