بناء اختبار تحقق +592 حول webhook والاستعلام الدوري

كيف أصمم تدفق واجهة OTP لغيانا قائمًا على webhook أولًا؟

في أي شيء يتجاوز فحصًا لمرة واحدة، دع المنصة تدفع الرموز إليك بدل أن تسأل مرارًا. في وحدة تحكم المطورين أضف نقطة نهاية HTTPS (يتسع الحساب لـ 5)، واشترك فيها بالحدث activation.sms_received إلى جانب activation.expired وactivation.cancelled، كي يعرف مشغّل اختباراتك بالطرق المسدودة بالسرعة التي يعرف بها النجاحات.

تعامل مع كل طلب وارد على أنه غير موثوق إلى أن يجتاز التحقق:

• اقرأ ترويسة X-OTPRoute-Signature التي تأخذ الشكل t=<unix>,v1=<hex>.
• اجمع الطابع الزمني ونقطة ثم جسم الطلب كما وصل دون تعديل، واحسب HMAC-SHA256 على هذا النص بسرّ نقطة النهاية.
• قارن الخلاصة بـ v1 بزمن ثابت، وأسقط الطلب إذا كان الطابع الزمني قديمًا.
• ابحث عن معرّف التفعيل في الحدث؛ فإن كنت عالجته من قبل فأعد نجاحًا ولا تفعل شيئًا آخر.

تُبقي هذه القاعدة الأخيرة المعالج idempotent، فلا تربك إعادة التسليم بعد عطل شبكي الاختبار. ويوجد شرح أطول في التقاط OTP عبر webhook.

ما نقاط النهاية والمعرّفات التي يستخدمها طلب +592؟

صادِق بمفتاح Bearer من وحدة تحكم المطورين؛ تبدأ المفاتيح الحية بـ or_live_ ويمكن للحساب الاحتفاظ بما يصل إلى 10. عنوان الأساس هو https://otproute.com/api/v1، ومعرّف دولة غيانا هو gy.

يقرأ التشغيل المعتاد GET /api/v1/prices?country=gy&service=<id> أولًا، لأن السعر والإتاحة على هذا المسار قيم حيّة لا ثوابت. ثم يرسل POST /api/v1/activations مع {"service": "<id>", "country": "gy"} ويتلقى رقم +592 ومعرّف تفعيل. وبلا webhook، يستعلم المشغّل عن GET /api/v1/activations/{id} كل بضع ثوانٍ، وهو أقل بكثير من سقف 300 طلب في الدقيقة. وتستدعي خطوة التنظيف POST /api/v1/activations/{id}/cancel حين يُجهض الاختبار، ويوقف استدعاء تمهيدي إلى GET /api/v1/balance المجموعة مبكرًا إذا كان الرصيد منخفضًا. تأتي معرّفات الخدمات من GET /api/v1/services؛ ويضم مركز المطورين أمثلة عملاء لواجهة التحقق عبر SMS هذه.

كيف تُنسَّق أرقام +592 للتخزين؟

تستخدم غيانا رمز الدولة 592 وأرقامًا وطنية من سبعة أرقام دون بادئة خط رئيسي لحذفها، فصيغة E.164 هي ببساطة +592 يليها الأرقام السبعة. ويكتب الناس الأرقام عادةً في مجموعة من ثلاثة ومجموعة من أربعة.

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

ما الخدمات التي تستقبل رموز OTP عبر SMS لغيانا، وهل أستطيع الطلب يدويًا؟

يسرد مسار غيانا أكثر من 900 خدمة. ومن الخدمات كثيرة الطلب WhatsApp وFacebook وInstagram وGoogle (Gmail & YouTube) وTikTok وTelegram وimo وViber وSnapchat وAmazon وMicrosoft & Outlook وDiscord وNetflix وClaude. وهذه القائمة لقطة من الكتالوج الحي، فتأكد عبر API أو لوحة التحكم قبل بناء اختبار حول مرسِل بعينه.

وللزملاء الذين لا يكتبون شيفرة، تؤدي لوحة التحكم المهمة نفسها. سجّل الدخول، وافتح OTP Gateway، واختر غيانا وخدمة، وراجع السعر، ثم اطلب. يظهر رقم التحقق الغياني ومعه عدّاد تنازلي لـ 20 دقيقة، ويُعرض الرمز بجانبه عند وصوله.

ماذا يفعل الاختبار حين يتأخر رمز +592 أو لا يصل؟

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

معالجة معقولة في تشغيل آلي:

1. انتظر انتهاء النافذة قبل إعلان الفشل، إلا إذا كان لاختبارك حد زمني صارم، وعندها ألغِ صراحةً.
2. أعد المحاولة لاحقًا، أو انتقل إلى مسار خدمة آخر إن وفّرته API.
3. تحقق من أن الخدمة المستهدفة تقبل الأرقام الافتراضية؛ فبعضها يرفضها، والاسترداد يغطي هذه الحالة بالذات.
4. باعد بين إعادة المحاولات بتأخير تصاعدي بدل إعادة الطلب في حلقة سريعة.

ويشرح دليل توجيه OTP حسب الدولة كيفية اختيار مسارات بديلة.

لماذا تختبر الفرق مسارات التسجيل الغيانية؟

غيانا هي الدولة الوحيدة في أمريكا الجنوبية التي لغتها الرسمية الإنجليزية، وتستضيف جورجتاون أمانة CARICOM العامة، ولذلك تظهر كثيرًا في الإطلاقات التي تعامل الجماعة الكاريبية كسوق واحدة. وقد اجتذب قطاع الطاقة البحرية سريع النمو مقاولين وموردين دوليين، بينما تُبقي جالية كبيرة في الولايات المتحدة وكندا والمملكة المتحدة تطبيقات التحويلات والمراسلة والسفر نشطة على أرقام +592. وتنتشر الكريولية الغيانية في الحياة اليومية، لكن نصوص التحقق تصل عمومًا بالإنجليزية. وبالنسبة لضمان الجودة، يوجّه ذلك الجهد إلى إدخال الأرقام ومنتقيات الدول وصياغة موافقة SMS لا إلى النصوص المترجمة. أبقِ كل فحص على حسابات تملكها مؤسستك، والتزم بشروط كل خدمة، وتذكّر أن سياسة الاستخدام المقبول في OTP Route تشمل جميع الطلبات.

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

لا تُقدَّم أرقام طويلة الأمد ذاتية الخدمة لغيانا. تغطي الأرقام المخصصة في OTP Route الولايات المتحدة وكندا فقط، من $1.95/month. وللحصول على خط +592 راسل [email protected] وسيتحقق الفريق مما تسمح به القواعد المحلية، دون وعد.

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

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

هل أستطيع فحص تسجيل تطبيقي في غيانا دون شريحة SIM من مشغّل غياني؟

نعم. اطلب رقم +592 من OTP Gateway لخدمتك، وأرسله في مسارك، فيظهر الرمز في لوحة التحكم أو يصل إلى webhook. تبدأ الأسعار من $0.20 للرمز.

ما معرّف الدولة الذي تستخدمه API لغيانا؟

هو gy، ويُستخدم في استعلام الأسعار وفي جسم طلب التفعيل معًا.

هل أحتاج إلى حذف صفر بادئ من الأرقام الغيانية؟

لا. ليس في غيانا بادئة خط رئيسي، فصيغة E.164 هي +592 يليها الرقم المكوّن من سبعة أرقام.

بأي لغة تأتي رسائل التحقق على +592؟

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

هل يوجد استرداد إن لم ترسل الخدمة الرسالة أبدًا؟

نعم، وهو تلقائي. إذا مرت 20 دقيقة دون رمز، أو ألغيت، يعود المبلغ كله إلى محفظتك.

هل أستطيع اختبار التكامل كله دون إنفاق مال؟

اطلب من الدعم تحويل حساب التطوير لديك إلى sandbox. يعيد أرقامًا ورموزًا محاكاة، فيمكن تجربة استدعاءات API وwebhook من الطرف إلى الطرف.

هل يتوفر رقم +592 طويل الأمد؟

ليس كمنتج ذاتي الخدمة. تُباع الأرقام المخصصة في الولايات المتحدة وكندا فقط؛ راسل [email protected] للاستفسار عن غيانا.

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