العربية
كيف تستقبل رموز OTP عبر SMS لكوسوفو بالـ API أو لوحة التحكم
يستطيع OTP Route استقبال رموز التحقق الكوسوفية (+383) نيابةً عنك: اطلب رقمًا مؤقتًا من OTP Gateway واقرأ الرمز في لوحة التحكم، أو اجمعه عبر REST API وwebhook موقّع. تبدأ الرموز من $0.20 للرمز، ولا تُفوتر إلا إذا وصلت الرسالة خلال نافذة الـ 20 دقيقة.
لماذا قد يحتاج فريق منتج إلى رقم +383 أصلًا؟
كوسوفو سوق صغير ببصمة كبيرة في الخارج: فجالية كبيرة منها تعيش في ألمانيا وسويسرا وبقية أوروبا الغربية، وكثير من أفرادها يحتفظون برقم كوسوفي للعائلة والخدمات المصرفية. والتطبيقات التي تخدم هذا الجمهور، من السفر إلى تحويل الأموال، تحتاج إلى رؤية ما يعيشه مستخدم +383 عند التسجيل.
والتوطين دافع آخر. فالألبانية والصربية كلتاهما رسمية، ولذلك يستحق تدفق مترجم إلى أي منهما اختبارًا حقيقيًا من طرف إلى طرف بدل مراجعة لقطات الشاشة. ويتيح رقم تحقق كوسوفي من OTP Gateway لفريق الجودة إجراء هذا الفحص من أي مكتب.
ولفرق العمليات الإقليمية في بريشتينا أو التي تغطي غرب البلقان سبب ثالث: فالملفات التجارية المسجلة بجهة اتصال محلية تطلب أحيانًا رمزًا جديدًا، وتمرير ذلك عبر أداة مشتركة قابلة للتدقيق أفضل من تمرير هاتف موظف من يد إلى يد.
ما التطبيقات الموجودة على مسار كوسوفو الآن؟
تُظهر لقطة اليوم أكثر من 400 خدمة لكوسوفو. ومن الخدمات الشائعة المتاحة حاليًا WhatsApp وViber وTelegram وFacebook وInstagram وTikTok وGoogle (Gmail & YouTube) وMicrosoft & Outlook وAmazon وSnapchat وNetflix وAirbnb وUber وFlipkart.
القائمة أصغر منها في الأسواق الأوروبية الأكبر وتتغير أكثر، فاعتبر أي قائمة مكتوبة مجرد إشارة. والجواب الحاسم هو ما تعيده GET /api/v1/countries ولوحة التحكم لحظة الطلب.
العمل مع واجهة OTP لكوسوفو عمليًا
معرّف الدولة هو xk. يحدد التكامل النموذجي معرّفات الخدمات من GET /api/v1/services، ويتحقق من التكلفة عبر GET /api/v1/prices?country=xk&service=<id>، ثم يفتح تفعيلًا بـ POST /api/v1/activations وجسم مثل {"service": "telegram", "country": "xk"}. تحمل الاستجابة الرقم ومعرّف تفعيل تحتفظ به لاحقًا.
بعدها يصلك الرمز كحدث webhook هو activation.sms_received، موقّعًا في ترويسة X-OTPRoute-Signature بـ HMAC-SHA256 على "<t>.<raw body>". ارفض الطوابع الزمنية القديمة، واجعل معالجك مرتبطًا بمعرّف التفعيل كي يُعالَج التسليم المُعاد مرة واحدة فقط. والاستعلام الدوري عن GET /api/v1/activations/{id} يعمل أيضًا حين لا يملك مشغّل CI عنوانًا عامًا. راجع دليل التكامل لأمثلة كاملة.
ما الذي تغيّر حين حصلت كوسوفو على +383، وكيف تُخزَّن الأرقام؟
حصلت كوسوفو على رمز دولتها الخاص +383 في أواخر العقد 2010 فقط. وقبل ذلك استخدمت شبكات الجوال فيها رموزًا مستعارة، منها رمزا موناكو وسلوفينيا، ولا تزال بعض سجلات العملاء القديمة تحمل أرقامًا بتلك الصيغ. إذا استوردت بيانات قديمة فعلّم تلك المدخلات بدل إعادة كتابتها تلقائيًا.
تبدأ الأرقام المحلية بالبادئة 0؛ فالجوال المعروض محليًا 044 123 456 هو +383 44 123 456 بصيغة E.164. احفظ الصيغة الدولية، واحذف الصفر عند الإدخال، ولا تنسّق إلا عند العرض. ويستخدم النص الألباني حروفًا مثل ë تقع خارج أبجدية GSM الأساسية، لذلك قد تُرسل الرسالة الموطّنة بترميز UCS-2 بأجزاء أقصر.
ماذا ينبغي أن يحدث حين يتأخر الرمز الكوسوفي أو يفقد؟
امنح التفعيل نافذته الكاملة البالغة 20 دقيقة. وحين تُغلق النافذة دون رسالة، أو تلغي، يُعكس الخصم إلى المحفظة تلقائيًا ويُطلق الحدث activation.expired أو activation.cancelled. الخطوات التالية المعقولة:
- حاول مجددًا بعد توقف أو اختر مسارًا مجاورًا، مثل ألبانيا، إن سمح اختبارك بذلك؛
- تحقق من أن الخدمة المستهدفة تقبل الأرقام الافتراضية أصلًا؛
- أضف تراجعًا متدرجًا إلى إعادة المحاولة الآلية بدل الطلب في حلقة.
الخطوط طويلة الأمد والمحفظة وsandbox لمشاريع كوسوفو
لا يوجد في OTP Route رقم طويل الأمد بالخدمة الذاتية لكوسوفو. فخط الأرقام المخصصة، بدءًا من $1.95/month، يغطي بلدين فقط: الولايات المتحدة وكندا. وللحصول على خط +383 دائم راسل [email protected]؛ وإمكان ترتيبه يعتمد على القواعد المحلية.
يُسحب الإنفاق من محفظة USD واحدة مدفوعة مسبقًا، ادفع حسب الاستخدام، وتُشحن بالبطاقة أو بـ USDT/USDC، مع إرسال فاتورة PDF بالبريد لكل عملية شحن. ويمكن للمطورين طلب وضع sandbox لحساب تطوير ليستقبلوا أرقامًا ورموزًا محاكاة أثناء ربط webhook. التفاصيل في الأسعار.
الأسئلة الشائعة
هل أستطيع فحص التسجيل بالألبانية في تطبيقي برقم كوسوفي حقيقي؟
نعم. اطلب رقم +383 للاختبار في OTP Gateway، وابدأ التسجيل بالألبانية، فيظهر الرمز في لوحة التحكم وفي webhook الخاص بك.
ما المعرّف الذي تستخدمه كوسوفو في واجهة التحقق عبر SMS؟
كوسوفو هي xk في كل نقطة نهاية تأخذ دولة، ومنها GET /api/v1/prices وPOST /api/v1/activations.
كم يكلّف رقم التحقق الكوسوفي؟
من $0.20 للرمز؛ ويعتمد السعر الدقيق على الخدمة ويُعرض قبل أن تطلب أو تعيده نقطة الأسعار.
لماذا أرى خدمات أقل لكوسوفو مقارنة بألمانيا؟
تتبع التغطية ما يستطيع شركاؤنا من مشغّلي الاتصالات توجيهه إلى كل دولة، والأسواق الأصغر لها قوائم أقصر. تحقق من القائمة الحية قبل التخطيط لتشغيل اختبار.
ماذا يحدث لمالي إن لم تصل رموز OTP الكوسوفية؟
يعود كاملًا إلى المحفظة حين تنتهي نافذة الـ 20 دقيقة دون رسالة، أو فورًا إن ألغيت.
هل لا تزال أرقام +377 أو +386 القديمة تخص مستخدمين كوسوفيين؟
قد تحتوي بعض السجلات القديمة عليها، لكن الأرقام الجديدة تستخدم +383. تعامل مع الصيغ الأقدم كبيانات للمراجعة لا تُحوَّل آليًا.
هل أستطيع الاحتفاظ برقم +383 لتسجيلات دخول متكررة؟
ليس بالخدمة الذاتية. يغطي كل رقم بوابة رمزًا واحدًا، والخطوط طويلة الأمد منتج للولايات المتحدة وكندا؛ راسل [email protected] للاستفسار عن كوسوفو.
هل توجد قواعد تحكم كيفية استخدامي لأرقام OTP Route؟
نعم. استخدم OTP Route لمنتجاتك وحساباتك التجارية المشروعة فقط، والتزم بشروط كل خدمة، واحترم سياسة الاستخدام المقبول. سجّل للبدء.
أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.