إدخال رموز التحقق الرأس-أخضرية (+238) في بيئة الاختبار لديك

ما نقاط النهاية التي يمسّها تفعيل +238؟

يحتاج تكامل OTP API للرأس الأخضر إلى قائمة قصيرة من الاستدعاءات تحت https://otproute.com/api/v1. يحمل كل طلب مفتاح Bearer يبدأ بـ or_live_، يُنشأ في وحدة تحكم المطورين. معرّف دولة الرأس الأخضر هو cv؛ ومعرّف الخدمة هو قيمة api_service للتطبيق الذي تختبره.

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

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

كيف أستقبل webhook الموقّعة لرمز الرأس الأخضر؟

يناسب الاستعلام الدوري سكربتًا واحدًا؛ أما حين تعمل عدة مهام بالتوازي فالـ webhook أرتب. سجّل نقطة نهاية في وحدة تحكم المطورين (يتسع الحساب لخمس) واشترك في activation.sms_received وactivation.expired وactivation.cancelled.

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

ما التطبيقات التي تستطيع إرسال رموز إلى رقم رأس-أخضري اليوم؟

يغطي الكتالوج الحي لـ cv أكثر من 800 خدمة. ومن الشائعة المفتوحة حاليًا WhatsApp وFacebook وInstagram وTikTok وGoogle (Gmail & YouTube) وMicrosoft & Outlook وAmazon وAirbnb وUber وViber وTelegram وNetflix. اقرأ القائمة كلقطة لحظية: تفتح المسارات وتُغلق بحسب سعة الشركاء، وهذا هو جوهر توجيه OTP عبر API يبلّغ عن الإتاحة آنيًا بدل صفحة تَعِد بها.

وإن لم يكن في الفريق من يكتب الشيفرة، فلوحة التحكم تؤدي المهمة نفسها. اختر الخدمة، ثم الرأس الأخضر، وأكّد السعر على الشاشة وانسخ الرقم. يظهر الرمز على بطاقة التفعيل حين يصل.

كيف يبدو رقم +238 عند تخزينه؟

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

البرتغالية هي اللغة الرسمية، بينما الكريولية الرأس-أخضرية هي ما يتحدثه معظم الناس يوميًا، فتحقق من كيفية عرض قالب OTP برتغالي على هاتف هناك. وعادةً تتخذ الفرق رقم +238 للاختبار بسبب المغتربين: فالجاليات الرأس-أخضرية في الولايات المتحدة والبرتغال وأوروبا عمومًا تُبقي حساباتها مرتبطة بأرقام الوطن، وتريد منتجات التحويلات والسفر والمراسلة أن تعمل تلك التسجيلات.

ماذا يحدث للمحفظة إذا لم تصل رسالة خلال 20 دقيقة؟

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

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

يتعمق دليل تقليل إخفاقات تسليم OTP في التشخيص.

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

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

كيف تُحتسب التكلفة وكيف أختبر قبل الإطلاق؟

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

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

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

نعم. اطلب رقم +238 من OTP Gateway، وأدخله في نموذج التسجيل واقرأ الرمز من لوحة التحكم أو API أو webhook. لا يحتاج أحد في الفريق إلى التواجد في الجزر.

ما معرّف دولة الرأس الأخضر في API الخاص بـ OTP Route؟

إنه cv. مرّره كقيمة country في POST /api/v1/activations وفي استعلام الأسعار.

هل أحتاج إلى إضافة 0 قبل الرقم الرأس-أخضري؟

لا. ليس في الرأس الأخضر بادئة محلية، فالصيغة الدولية هي +238 متبوعة بالرقم الوطني من سبع خانات.

كم يكلف رقم التحقق للرأس الأخضر؟

يبدأ سعر OTP Gateway من $0.20 للرمز ويختلف بحسب الخدمة؛ ويعرض API ولوحة التحكم السعر الدقيق قبل أن تطلب. ولا تُحاسَب إلا إذا وصل رمز.

هل سيرسل كل تطبيق رموزًا إلى رقم افتراضي رأس-أخضري؟

لا. بعض الخدمات ترفض الأرقام الافتراضية، وتتغير المسارات خلال اليوم. وإذا لم يصل رمز خلال 20 دقيقة يُرد المبلغ إلى المحفظة.

هل يوجد sandbox لاختبار تكامل +238؟

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

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