العربية
واجهة OTP API لساموا: اختبار التسجيل برقم +685 في المحيط الهادئ
يتيح لك OTP Route استقبال رموز التحقق من ساموا (+685) عبر طلب رقم لمرة واحدة من OTP Gateway، ثم قراءة الرسالة في لوحة التحكم أو سحبها عبر API وwebhooks، من $0.20 للرمز. أمامك 20 دقيقة لوصول الرسالة، ويُردّ إليك المبلغ كاملًا إن لم تصل.
ساموا باختصار لفرق المنتج والاختبار
ساموا دولة مستقلة في المحيط الهادئ، لغتاها الرسميتان السامية والإنجليزية. تعيش جالية سامية كبيرة في نيوزيلندا وأستراليا والولايات المتحدة، ولذلك تحتاج تطبيقات التحويلات والمراسلة والسفر غالبًا إلى العمل مع مستخدمين يتنقلون بين تلك البلدان والوطن.
هناك أمران يستحقان الانتباه. الأول أن ساموا (+685) دولة مختلفة عن ساموا الأمريكية التي تقع ضمن خطة الترقيم لأمريكا الشمالية بالمفتاح +1 684، وقد يؤدي الخلط بينهما في قائمة الدول إلى إرسال الرموز إلى وجهة خاطئة. والثاني أن ساموا انتقلت عام 2011 إلى الجانب الغربي من خط التاريخ الدولي وأصبحت ساعتها متقدمة كثيرًا عن التوقيت العالمي، ما يجعلها حالة مفيدة لاختبار حدود التواريخ في منطق انتهاء الصلاحية.
نادرًا ما تكون ساموا سوقًا مستقلًا لإطلاق منتج. فهي تظهر عادةً ضمن إطلاق إقليمي في المحيط الهادئ، أو بسبب متطلبات تطبيق موجّه للجاليات، أو لأن جهة شريكة في أبيا تحتاج إلى تأكيد حساب أعمال. والمهمة في كل الحالات واحدة: إثبات أن مستخدمًا برقم +685 يستطيع إكمال مسار التسجيل لديك.
كيف يُعامَل رقم +685 في الشيفرة؟
أرقام ساموا الوطنية قصيرة مقارنةً بمعظم الأسواق، لذا قد ترفض أدوات التحقق المضبوطة على تسعة أو عشرة أرقام رقمًا صحيحًا. احفظ الأرقام بالصيغة +685 متبوعة بالأرقام الوطنية دون فواصل، واحذف أي صفر يضيفه المستخدم بحكم العادة. وبما أن الطوابع الزمنية في webhook بالثواني بتوقيت Unix، فقارنها بالتوقيت العالمي لا المحلي؛ هكذا تتجنب المفاجآت حين يكون خادمك ومختبِر في ساموا في يومين تقويميين مختلفين.
وإذا كان منتجك يسمح بالتبديل بين رقم نيوزيلندي ورقم سامي في الملف الشخصي نفسه، فأضف اختبارًا يغيّر رمز الدولة ويتأكد من مسح حالة التحقق السابقة، حتى لا يُقبل رمز أُرسل إلى رقم ما لرقم آخر.
ما الخدمات المتاحة على مسارات ساموا؟
يضم فهرس ساموا حاليًا أكثر من 600 خدمة. ومن الخدمات الشائعة الطلب WhatsApp وFacebook وInstagram وTelegram وGoogle (Gmail & YouTube) وViber وSignal وTikTok وMicrosoft & Outlook وAmazon وDiscord. التغطية هنا أقل منها في الأسواق الكبيرة وتتغير على مدار اليوم، لذا راجع GET /api/v1/services وGET /api/v1/countries قبل كل تشغيل. وإذا غابت خدمة ما، فقد يناسب اختبارك مسار مجاور مثل فيجي أو تونغا.
والفهرس الأخف سبب وجيه لجعل بيئة الاختبار متسامحة: إذا غابت الخدمة المفضلة وقت التشغيل، فصنّف الحالة «متخطاة» بدل «فاشلة» وسجّلها ليعيد أحدهم المحاولة لاحقًا.
طلب رمز من ساموا عبر API
باستخدام مفتاح Bearer (or_live_…) مع العنوان https://otproute.com/api/v1، اطلع على السعر عبر GET /api/v1/prices?country=ws&service=<id>، ثم أرسل {"service": "<id>", "country": "ws"} إلى POST /api/v1/activations. تابع معرّف التفعيل بالاستعلام الدوري عبر GET /api/v1/activations/{id} أو بالاستماع إلى الحدث activation.sms_received. تحقق من توقيع HMAC في ترويسة X-OTPRoute-Signature مع كل webhook، وارفض الطوابع الزمنية القديمة، واجعل المعالج آمنًا عند تنفيذه مرتين لنفس التفعيل. ويعرض دليل التكامل الصورة الكاملة.
حدود الاستخدام سخية لسوق بهذا الحجم: يتيح كل حساب حتى 10 مفاتيح و5 نقاط webhook و300 طلب في الدقيقة. وإذا كنت تعتمد الاستعلام الدوري فتكفي فاصلة من بضع ثوانٍ بين كل فحص.
التنفيذ يدويًا من لوحة التحكم
- سجّل الدخول وافتح OTP Gateway.
- اختر الخدمة ثم ساموا.
- راجع السعر المباشر وأكّد.
- الصق الرقم +685 في التطبيق قيد الاختبار واطلب الرمز.
- اقرأ الرمز على الشاشة، أو ألغِ الطلب إن لم تعد بحاجة إليه.
عندما يتأخر رمز +685 أو لا يصل
أبقِ التفعيل مفتوحًا طوال 20 دقيقة قبل أن تستسلم. بعض التطبيقات ترفض الأرقام الافتراضية تمامًا، ولهذا السبب بالذات تُردّ قيمة الطلبات التي لم يصلها شيء. وإذا بقي مسار ما صامتًا، فجرّب لاحقًا أو اختر مسار خدمة آخر؛ فإطلاق طلبات جديدة في حلقة سريعة نادرًا ما يفيد ويستنزف حد الطلبات لديك.
سجّل معرّف التفعيل مع كل محاولة لتعرف هل جاء الصمت من تطبيق بعينه أم من المسار كله.
الأرقام طويلة الأمد والدفع مقابل الاستخدام
لا يبيع OTP Route رقمًا سامويًا طويل الأمد بالخدمة الذاتية. تبدأ الأرقام المخصصة (Dedicated Numbers) من $1.95 شهريًا وتقتصر على الولايات المتحدة وكندا؛ وللحصول على خط في ساموا راسل [email protected] دون وعد بإمكانية توفيره. وتقبل المحفظة المدفوعة مسبقًا بالدولار الأمريكي البطاقات وعملتي USDT/USDC، وترسل فاتورة PDF عن كل عملية شحن، ولا رسوم شهرية. اطلب وضع sandbox على حساب التطوير لتجربة مسار ws دون إنفاق أي رصيد.
الأسئلة الشائعة
هل ساموا هي نفسها ساموا الأمريكية من حيث أرقام الهاتف؟
لا. تستخدم ساموا المفتاح +685 بينما تستخدم ساموا الأمريكية +1 684. اختر الدولة الصحيحة في قائمة الدول لديك وفي API.
ما معرّف الدولة لساموا في API؟
استخدم ws في استعلام الأسعار وفي طلب التفعيل.
كم يكلّف رمز التحقق من ساموا؟
من $0.20 للرمز؛ ويتوقف السعر الدقيق على الخدمة ويُعرض لك قبل الطلب.
هل أستطيع اختبار تسجيل مستخدم سامي من نيوزيلندا أو أستراليا؟
نعم. يستقبل الرقم +685 الرسالة ويعرضها OTP Route لك أينما يعمل فريقك.
هل أدفع إن لم تصل أي رسالة؟
لا. تُردّ التفعيلات المنتهية أو الملغاة إلى المحفظة تلقائيًا.
بأي لغة تصل رموز ساموا؟
غالبًا بالإنجليزية، وهي لغة رسمية إلى جانب السامية. اقرأ الأرقام لا النص المحيط بها.
هل يمكنني استخدام هذه الأرقام لفتح عدد كبير من الحسابات؟
لا. التزم بشروط كل خدمة؛ فسياسة الاستخدام المقبول تقصر استخدام OTP Route على اختبار منتجاتك الخاصة وتشغيل حساباتك المشروعة.
أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.