جمع رموز OTP الإندونيسية +62 برمجيًا

ما نقاط النهاية التي يستدعيها تكامل واجهة OTP لإندونيسيا؟

يعمل كل شيء على https://otproute.com/api/v1 بمفتاح Bearer يحمل البادئة or_live_. أنشئ واحدًا في وحدة تحكم المطورين؛ ويمكن للحساب الاحتفاظ بما يصل إلى 10 مفاتيح، مما يسهّل فصل مشغّل CI عن جهاز staging.

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

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

كيف أعالج رموز +62 بـ webhook موقّع؟

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

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

تعامل مع الأحداث على أنها مرتبطة بمعرّف التفعيل واجعل المعالج idempotent: فيجد التسليم المعاد الرمز مخزنًا بالفعل. ويستعرض مقالنا عن أمان webhook عبر HMAC الفحوص.

أي الخدمات تستقبل OTP عبر SMS الإندونيسي على OTP Route؟

تغطي اللقطة الحية لإندونيسيا أكثر من 3,000 خدمة. ومن المسارات الشائعة WhatsApp وTokopedia وShopee وLazada وTelegram وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وLINE وDiscord وMicrosoft & Outlook وChatGPT (OpenAI).

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

كيف ينبغي تخزين رقم +62 وتوحيده؟

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

وكثيرًا ما تكون قوالب SMS المرسلة إلى الأرقام الإندونيسية بلغة الباهاسا الإندونيسية، وإن أرسلت بعض الخدمات بالإنجليزية. استخرج الرمز بنمط أرقام بدل مطابقة كلمات مثل "kode" أو "code"، فلا يهتم محللك بلغة القالب.

لماذا تختبر فرق المنتج مسارات التسجيل في إندونيسيا؟

إندونيسيا من أكثر دول العالم سكانًا واستخدامها للإنترنت يعتمد بشدة على الجوال أولًا، ولذلك يقع التحقق برقم الهاتف في مقدمة كثير من مسارات الانضمام. وتريد الفرق المتوسعة في جنوب شرق آسيا أن ترى شاشات التسجيل وتسجيل الدخول الإندونيسية لديها تعمل بشكل صحيح مع رقم +62 حقيقي، وأن تتأكد من أن نصوص الباهاسا الإندونيسية تُعرض دون اقتطاع، وأن قواعد مكافحة الاحتيال لا تحجب مستخدمين محليين مشروعين.

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

ماذا لو لم يظهر الرمز الإندونيسي أبدًا؟

يعتمد زمن التسليم على الخدمة والمسار، فامنح التفعيل مهلة قبل الحكم عليه بالفشل. عندما لا تصل رسالة SMS:

• دع نافذة الـ 20 دقيقة تنتهِ، أو ألغِ؛ وفي الحالتين يعود المبلغ كاملًا إلى محفظتك تلقائيًا.
• اطلب مجددًا بعد قليل، أو جرّب مسار خدمة آخر إذا سمح اختبارك.
• تأكد من أن الخدمة المستهدفة تقبل الأرقام الافتراضية لهذا الإجراء. بعضها لا يقبلها، وهذا بالضبط سبب قاعدة الاسترداد.
• تجنب إعادة الطلب في حلقة سريعة. باعد بين المحاولات كي لا تستهلك مهمة CI إعاداتها في ثوانٍ.

وتجد مزيدًا من أفكار التشخيص في تقليل إخفاقات تسليم OTP.

هل يوجد رقم +62 مخصص، وكيف يُفوتر؟

لا. لا يُقدَّم خط إندونيسي طويل الأمد ذاتي الخدمة. الأرقام المخصصة منتج للولايات المتحدة وكندا، من $1.95/month. وإذا كان فريقك يحتاج فعلًا إلى خط +62 دائم فراسل [email protected]؛ وإمكان ترتيبه يعتمد على القواعد المحلية ولا وعد به.

تستخدم فوترة OTP Gateway محفظة واحدة بالدولار الأمريكي مدفوعة مسبقًا دون رسوم شهرية ودون خطة تختارها. اشحن المحفظة بالبطاقة أو بعملتي USDT/USDC المستقرتين؛ وتُنتج كل عملية شحن فاتورة PDF بالبريد لسجلاتك المالية. ويمكن لحسابات التطوير طلب وضع sandbox، الذي يعيد أرقامًا ورموزًا محاكاة لاختبارات التكامل من الطرف إلى الطرف دون إنفاق أموال. راجع الأسعار أو أنشئ حسابًا.

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

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

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

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

إندونيسيا هي id، فيُكتب استعلام السعر هكذا: GET /api/v1/prices?country=id&service=<id>.

هل أدفع إذا لم تصل رسالة SMS الإندونيسية أبدًا؟

لا. إذا لم يصل شيء خلال نافذة الـ 20 دقيقة، أو ألغيت، يعود المبلغ المخصوم كاملًا إلى محفظتك تلقائيًا.

هل أحتفظ بالصفر البادئ عند حفظ رقم جوال إندونيسي؟

احتفظ به للعرض بالصيغة المحلية فقط. خزّن +62 يليها الرقم الوطني دون الصفر، وهي صيغة E.164.

هل ستكون نصوص التحقق الإندونيسية بالإنجليزية؟

ليس دائمًا. كثير منها يصل بالباهاسا الإندونيسية، فحلّل الرمز الرقمي ولا تعتمد على الكلمات المحيطة.

هل تُسمح الأرقام الإندونيسية لأي غرض؟

الاستخدام المشروع فقط: اختبار منتجاتك وحساباتك وتشغيلها ضمن شروط كل خدمة. وتسري سياسة الاستخدام المقبول في OTP Route على كل طلب.

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