استقبال رموز التحقق الهندية (+91) عبر API

كيف يبدو تسلسل استدعاءات واجهة OTP للهند؟

التدفق كله حفنة طلبات على https://otproute.com/api/v1، مصادَق عليها بمفتاح Bearer يبدأ بـ or_live_. تأتي المفاتيح من وحدة تحكم المطورين، حتى 10 لكل حساب، فيمكن لكل بيئة أن يكون لها مفتاحها.

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

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

كيف يُبنى معالج webhook لرموز +91؟

يتوسع webhook الموقّع أفضل من الاستعلام الدوري حين تعمل المهام بالتوازي. سجّل نقطة نهاية في وحدة تحكم المطورين (حتى 5 لكل حساب) واستمع إلى activation.sms_received وactivation.expired وactivation.cancelled.

يحمل كل تسليم ترويسة X-OTPRoute-Signature بالشكل t=<unix>,v1=<hex>. وللتحقق منها، احسب HMAC-SHA256 على النص <t>.<raw body> بسرّ تلك النقطة وقارن النتيجة بـ v1 بزمن ثابت. وتفصيلان يوقعان الناس:

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

اربط كتاباتك بمعرّف التفعيل ليصبح التسليم المكرر بلا أثر، وأكّد بـ 2xx قبل تنفيذ أي عمل بطيء. ويشرح مقالنا عن تأمين webhook الخاص بـ OTP عبر HMAC خطوة المقارنة سطرًا بسطر.

أي الخدمات تستطيع إرسال رموز إلى أرقام هندية؟

يسرد مسار الهند حاليًا أكثر من 2,300 خدمة. ومن الإدخالات الشائعة في اللقطة الحية WhatsApp وTelegram وGoogle (Gmail & YouTube) وInstagram وFacebook وX (Twitter) وChatGPT (OpenAI) وMicrosoft & Outlook وAmazon وLinkedIn وDiscord وUber وSnapchat.

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

هل يستطيع غير المطورين طلب رقم تحقق هندي من لوحة التحكم؟

نعم. يستطيع موظفو العمليات ومديرو حسابات الوكالات تجاوز API:

1. أنشئ حسابًا ببريدك الإلكتروني ورمز بريد من 6 أرقام أو بتسجيل الدخول عبر Google، ثم فعّل المصادقة الثنائية TOTP.
2. اشحن المحفظة.
3. اختر الهند والخدمة، وتحقق من السعر على الشاشة، وأرسل الطلب.
4. اكتب الرقم +91 في التطبيق الذي تعدّه؛ يظهر الرمز على صفحة التفعيل حين تصل الرسالة.

تتشارك لوحة التحكم وAPI نافذة واحدة وقاعدة استرداد واحدة ومحفظة واحدة.

ماذا أفعل إذا لم يصل رمز خلال 20 دقيقة؟

يبقى كل تفعيل مفتوحًا 20 دقيقة. لا تدفع إلا إذا وصلت الرسالة: فحين تُغلق النافذة فارغة، أو تلغي قبل ذلك، يعود المبلغ كاملًا إلى محفظتك تلقائيًا ويتلقى webhook لديك activation.expired أو activation.cancelled.

إذا فُقد رمز:

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

وتجد معالجة أطول لاستراتيجية إعادة المحاولة في تقليل إخفاقات تسليم OTP.

كيف ينبغي تخزين أرقام الهاتف الهندية وتوحيدها؟

أرقام الجوال الهندية من عشرة أرقام وتبدأ عمليًا بـ 6 أو 7 أو 8 أو 9. ويكتبها الناس داخل الهند غالبًا مع 0 بادئة للخط الرئيسي، أو يقسمونها خمسة وخمسة بمسافة. وتحذف الصيغة الدولية ذلك الـ 0 وتضيف رمز الدولة، فتصبح +91 يليها الأرقام العشرة.

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

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

لماذا تحتاج فرق المنتج إلى رقم +91 للاختبار؟

الهند سوق إطلاق شائع لتطبيقات المستهلكين وتسجيل التقنية المالية والأسواق الإلكترونية، ويتوقع مستخدموها خطوة SMS عند التسجيل. وتستخدم الفرق مسارات +91 لتجربة إطلاق، ولمراجعة التوطين عبر واجهات بالهندية والتاميلية والتيلوغوية والبنغالية والماراثية وغيرها، ولدعم موظفي العمليات الإقليميين، وللتحقق من تدفقات عملاء الجالية الهندية في الخارج الذين لا يزالون يسجلون الدخول برقم الوطن. وتوجيه OTP الجيد هنا يعني اختيار مسار الخدمة الذي يطابق رحلة المستخدم الحقيقية، ثم ربطه باستدعاءات واجهة التحقق عبر SMS نفسها التي تستخدمها أسواقك الأخرى.

هل يوجد خط هندي طويل الأمد، وكيف تعمل الفوترة؟

لا. الأرقام المخصصة منتج للولايات المتحدة وكندا، من $1.95/month، ولا يمكنك شراء خط هندي طويل الأمد من لوحة التحكم. وإذا احتجت إلى واحد فراسل [email protected]؛ فالتوفر يعتمد على القواعد المحلية وغير مضمون.

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

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

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

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

ما معرّف الدولة للهند في API الخاصة بـ OTP Route؟

هو in. مرّره دولةً في GET /api/v1/prices وفي جسم POST /api/v1/activations.

كم تكلف استقبال رمز OTP عبر SMS للهند؟

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

هل أستطيع إعادة استخدام رقم +91 نفسه لتسجيل الدخول الشهر القادم؟

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

هل يوجد sandbox لبناء تكامل الهند؟

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

هل يستطيع فريقنا المالي الدفع بالعملات المستقرة؟

نعم. تقبل المحفظة الدفع بالبطاقة وبعملتي USDT وUSDC، وتنتج كل عملية شحن فاتورة PDF بالبريد.

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