قائمة تحقق لاستقبال رموز SMS من Twitch على أرقام OTP Route

قائمة الفحص قبل أول طلب لـ Twitch

راجع ما يلي قبل أن تطلب رقمًا:

• الغرض مشروع: أنت تختبر تكاملك الخاص أو إضافة، أو تشغّل حساب قناة تملكه مؤسستك.
• مفتاح API جاهز: مفتاح Bearer (بادئة or_live_) من Developer console.
• نقطة نهاية webhook مسجلة، مع حفظ سرها على الخادم.
• الدولة مختارة لتطابق جمهور الحساب أو حالة الاختبار.
• المحفظة مشحونة، أو طلب sandbox لتجربة بلا تكلفة.
• تم التحقق من الحاجة الطويلة الأمد: إذا كان على الحساب إعادة التحقق لاحقًا، فاقرأ القسم الأخير أولًا.

أين يطلب Twitch رقم هاتف؟

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

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

من أي دولة يجب أن يأتي رقم Twitch؟

تتوفر خدمة Twitch على مسارات في 197 دولة، منها الولايات المتحدة وكندا والمملكة المتحدة وألمانيا والبرازيل واليابان والمكسيك وفرنسا وإسبانيا وبولندا وكوريا الجنوبية وتركيا والفلبين وأستراليا.

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

خطوة بخطوة: رمز OTP من Twitch عبر API

1. تأكد من أن معرّف الخدمة هو twitch عبر GET /api/v1/services، واختر معرّف دولة من GET /api/v1/countries.
2. تحقق من التكلفة: GET /api/v1/prices?country=<id>&service=twitch.
3. اطلب: POST /api/v1/activations مع {"service": "twitch", "country": "<id>"}.
4. أدخل الرقم المُعاد في حقل الهاتف في Twitch.
5. انتظر activation.sms_received، أو استعلم دوريًا عن GET /api/v1/activations/{id}.
6. أرسل الرمز وأنهِ اختبارك.

عنوان الأساس هو https://otproute.com/api/v1، مع 300 طلب في الدقيقة لكل حساب. في مهمة CI، غلّف الخطوات من 3 إلى 6 في fixture اختبار واحد يلغي التفعيل في مرحلة التفكيك، كي لا يترك تشغيل ملغى أي طلب معلقًا؛ يعرض اختبار OTP عبر SMS في خطوط CI هذا الأسلوب.

كيف يُكتب معالج webhook؟

يتضمن كل تسليم X-OTPRoute-Signature: t=<unix>,v1=<hex>. أعد حساب HMAC-SHA256 على <t>.<raw body> بسر نقطة النهاية، وقارن في زمن ثابت، وارفض الطوابع الزمنية القديمة. واجعل المعالج idempotent بالاعتماد على معرّف التفعيل، حتى لا يؤدي تسليم أُعيد إرساله إلى إدخال رمز Twitch نفسه مرتين. وإذا تعذّر الوصول إلى نقطة النهاية لديك، فالاستعلام الدوري عن التفعيل بديل معقول. راجع التقاط OTP عبر webhook.

خطوات لوحة التحكم لمديري المجتمعات والقنوات

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

استكشاف الأخطاء: لا رمز، رقم مرفوض، نافذة منتهية

• لم يصل شيء: دع نافذة الـ 20 دقيقة تنتهي. الانتهاء أو الإلغاء يعيد المبلغ كاملًا تلقائيًا.
• رفض Twitch الرقم: قد يرفض Twitch الأرقام الافتراضية؛ جرّب مسار دولة آخر لاحقًا.
• إخفاقات متكررة: توقف مؤقتًا بدل إعادة الطلب في حلقة سريعة، وتأكد من إدخال الرقم الدولي كاملًا.
• إرسال رمز خاطئ: تأكد من أن المعالج يقرأ أحدث تفعيل، لا نسخة مخزنة من تفعيل سابق.
• أخطاء التكامل: اطلب sandbox لإعادة تشغيل المسار برموز محاكاة.

متى يكون الرقم المخصص الأمريكي أو الكندي أنسب

رقم Gateway يستقبل رمزًا واحدًا ثم يزول. وإذا كان حساب Twitch سيحتاج إلى رموز مجددًا، لتسجيل دخول بخطوتين أو للاستعادة على حساب فريق مشترك، فإن الرقم المخصص هو الأداة الأفضل. يُباع هذا الرقم فورًا في الولايات المتحدة وكندا فقط، بدءًا من $1.95 شهريًا، ويعيد توجيه الرسائل الواردة إلى webhook الخاص بك.

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

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

هل يمكنني استقبال رمز OTP من Twitch دون هاتف شخصي؟

نعم. يستطيع الفريق طلب رقم للخدمة twitch على OTP Gateway وقراءة الرمز في لوحة التحكم، مع إبقاء هواتف الموظفين بعيدة عن حسابات العلامة التجارية.

كم يكلف رمز Twitch؟

من $0.20 لكل رمز، حسب الدولة. ويأتي السعر الحالي من GET /api/v1/prices قبل الطلب.

لماذا لم يرسل Twitch رمزًا إلى رقمي؟

يعتمد التسليم على المسار، وقد يرفض Twitch بعض الأرقام الافتراضية. انتظر انتهاء النافذة لتحصل على استرداد تلقائي، ثم أعد المحاولة لاحقًا أو في دولة أخرى.

هل الرقم الافتراضي لـ Twitch مناسب لتسجيل الدخول بالمصادقة الثنائية؟

الخط طويل الأمد وحده هو المنطقي هناك. استخدم رقمًا مخصصًا أمريكيًا أو كنديًا، لأن أرقام Gateway تستقبل رمزًا واحدًا.

هل يمكنني تشغيل التحقق عبر SMS في Twitch للاختبار ضمن CI؟

نعم. أطلق الطلبات من خط الأنابيب عبر API واستهلك webhook؛ ويتيح sandbox تجنب إنفاق رصيد المحفظة أثناء التطوير.

هل OTP Route مرتبطة بـ Twitch؟

لا. Twitch علامة تجارية مملوكة لأصحابها، ولا ترتبط OTP Route بها بأي صلة.

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