قائمة فحص مسبق لأرقام التحقق في جزر كايمان

قائمة الفحص المسبق: ما الذي ينبغي تجهيزه قبل طلب رقم +1 345؟

مرّ على هذه القائمة مرة واحدة، فيمرّ أول تفعيل في كايمان عادةً دون مفاجآت:

• الحساب والأمان. سجّل ببريد إلكتروني ورمز بريد من 6 خانات (أو بتسجيل الدخول عبر Google)، ثم فعّل المصادقة الثنائية TOTP لكل من يستطيع الإنفاق من المحفظة.
• محفظة ممولة. اشحن المحفظة المسبقة الدفع بالدولار الأمريكي بالبطاقة أو بـ USDT/USDC. لا توجد باقة تختارها ولا رسوم شهرية.
• مفتاح API. أنشئ مفتاحًا في وحدة تحكم المطورين؛ يبدأ بـ or_live_ ويوضع في ترويسة Bearer. يمكن للحساب الاحتفاظ بما يصل إلى 10 مفاتيح.
• نقطة نهاية webhook. سجّل عنوانًا واحفظ سرّه في مكان يستطيع معالجك قراءته. الحد الأقصى خمس نقاط نهاية لكل حساب.
• ضبط تحليل الهاتف. تأكد أن مكتبة الأرقام لديك تربط رمز المنطقة 345 بجزر كايمان بدل أن تعتبر كل رقم +1 أمريكيًا افتراضيًا.
• sandbox لتجربة جافة. اطلب من الدعم تحويل حساب تطوير إلى وضع sandbox لتختبر أرقام ورموز محاكاة تكاملك دون المساس بأموال المحفظة.

يسرد مرجع API كل حقل سيظهر في الاستجابات.

لماذا يربك رقم كايماني شيفرة تفترض أن +1 تعني أمريكا؟

تقع جزر كايمان ضمن خطة الترقيم لأمريكا الشمالية (NANP)، فتتشارك رمز الدولة 1 مع الولايات المتحدة وكندا وقائمة طويلة من الأقاليم الكاريبية. والذي يميّز خط كايمان هو رمز المنطقة 345. الرقم الكامل عشر خانات بعد رمز الدولة، يُكتب محليًا (345) NXX-XXXX ويُخزَّن بصيغة E.164 على هيئة +1345 متبوعة بسبع خانات.

ثلاث نتائج عملية للمهندسين:

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

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

ما الخدمات التي تستطيع توجيه الرموز إلى رقم تحقق في جزر كايمان؟

تضم اللقطة الحية للدولة ky حاليًا WhatsApp وTelegram وGoogle (Gmail & YouTube) وMicrosoft & Outlook وLinkedIn وAmazon وAirbnb وUber وSignal وDiscord وChatGPT (OpenAI) وNetflix وeBay. وبحساب الذيل الطويل يغطي المسار أكثر من 600 خدمة، وتتحرك القائمة خلال اليوم، ولهذا تُقرأ الإتاحة دائمًا من API بدل تثبيتها في الشيفرة.

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

خطوة بخطوة: كيف يجري تسلسل استدعاءات OTP API لجزر كايمان؟

تذهب كل الاستدعاءات إلى https://otproute.com/api/v1 بمفتاح Bearer لديك، ضمن حد 300 طلب في الدقيقة.

1. استدعِ GET /api/v1/services مرة واحدة وخزّن معرّفات الخدمات التي تحتاجها مجموعة اختباراتك.
2. استدعِ GET /api/v1/prices?country=ky&service=<id> لقراءة السعر الحي والتأكد أن الزوج متاح حاليًا.
3. أرسل POST /api/v1/activations بجسم مثل {"service": "<id>", "country": "ky"}. تحمل الاستجابة معرّف التفعيل ورقم +1 345.
4. أدخل ذلك الرقم في التطبيق قيد الاختبار وشغّل خطوة SMS فيه.
5. انتظر activation.sms_received على webhook الخاص بك. افحص الترويسة X-OTPRoute-Signature أولًا: احسب HMAC-SHA256 على <t>.<raw body> بسر نقطة النهاية، وقارنه بـ v1، وارفض الطوابع الزمنية القديمة.
6. بلا webhook، استعلم دوريًا عن GET /api/v1/activations/{id} بفاصل معتدل حتى يظهر الرمز أو تنتهي النافذة.
7. إذا أُلغي الاختبار فاستدعِ POST /api/v1/activations/{id}/cancel كي يعود المبلغ المحجوز إلى المحفظة.

يشرح دليل HMAC لـ webhook فحوص التوقيع سطرًا بسطر.

خطوة بخطوة للزملاء الذين يفضلون لوحة التحكم

لا يحتاج موظفو الدعم ومديرو الحسابات إلى لمس API إطلاقًا:

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

تسري نافذة 20 دقيقة وقاعدة الاسترداد تمامًا كما تسري عبر API.

استكشاف الأخطاء: ماذا لو لم يصل أي رمز إلى رقم +1 345؟

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

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

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

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

لا يوجد رقم طويل الأجل بخدمة ذاتية لجزر كايمان. ومشاركة رمز الدولة +1 لا تغيّر ذلك: فـ الأرقام المخصصة منتج للولايات المتحدة وكندا فقط، يبدأ من $1.95/month، مع رسائل SMS واردة وصادرة ومكالمات من المتصفح. وإذا احتاج فريقك إلى خط 345 دائم فراسل [email protected]؛ والإتاحة تعتمد على القواعد المحلية وليست مضمونة.

وكل ما عدا ذلك يعمل من محفظة واحدة مسبقة الدفع بالدولار الأمريكي. ينتج عن كل شحن بالبطاقة أو بـ USDT/USDC فاتورة PDF عبر البريد، وتشرح صفحة الأسعار نموذج الدفع حسب الاستخدام.

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

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

نعم. اطلب رقم +1 345 عبر OTP Gateway، وأدخله في تطبيقك، واقرأ الرمز في لوحة التحكم أو عبر API. تدفع من $0.20 للرمز، وعند وصول الرمز فقط.

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

المعرّف هو ky. مرّره قيمةً لـ country عند استدعاء GET /api/v1/prices أو POST /api/v1/activations.

كيف أخزّن رقم هاتف كايماني في قاعدة بياناتي؟

خزّنه بصيغة E.164: +1345 متبوعة بالرقم الفرعي من سبع خانات، دون مسافات أو علامات ترقيم. واكتشف الإقليم من رمز المنطقة 345 لا من البادئة +1.

هل يُعد رقم +1 345 أمريكيًا بالنسبة للأرقام المخصصة؟

لا. تُباع الأرقام المخصصة للولايات المتحدة وكندا فقط، فخط كايمان متاح حصرًا كتفعيل لرمز واحد في OTP Gateway.

ماذا يحدث لمالي إذا لم تصل الرسالة؟

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

هل أستطيع تشغيل اختبارات OTP لكايمان في CI دون إنفاق من المحفظة؟

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

كم خدمة يغطي OTP Route في كايمان؟

أكثر من 600 وقت أحدث لقطة. ولأن المخزون يتبدل خلال اليوم، استعلم من GET /api/v1/services ونقطة الأسعار لمعرفة الإتاحة الحية.

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