العربية
استلام رموز OTP عبر SMS من التشيك عبر نقاط النهاية أو Webhooks أو لوحة التحكم
نعم، تستطيع OTP Route استلام رموز التحقق عبر SMS من جمهورية التشيك (+420) على رقم لمرة واحدة من OTP Gateway، وتُسلَّم إلى لوحة التحكم أو إلى شيفرتك عبر الاستعلام الدوري بـ REST وWebhooks موقّعة. تبدأ الأسعار من $0.20 للرمز، ولا يُخصم منك إلا إذا وصل الرمز إلى الرقم خلال نافذة الـ 20 دقيقة.
ما نقاط النهاية التي تعتمد عليها واجهة OTP للتشيك؟
يعمل كل شيء على https://otproute.com/api/v1 بمفتاح Bearer يبدأ بالبادئة or_live_. تنشئ المفاتيح في وحدة تحكم المطوّرين، ويتسع الحساب لما يصل إلى 10 مفاتيح، فيسهل منح بيئة الاختبار وCI والحاسوب المحمول المحلي بيانات اعتماد منفصلة يمكن إلغاؤها بشكل مستقل. حدّ الطلبات هو 300 طلب في الدقيقة لكل حساب.
يبدو تشغيل نموذجي لرقم +420 هكذا:
- اجلب
GET /api/v1/countriesوGET /api/v1/servicesمرة مع كل نشر واحفظهما مؤقتًا. معرّف التشيك هوcz. - اسأل
GET /api/v1/prices?country=cz&service=<id>عن السعر الحي للمسار الذي تنوي استخدامه؛ فهو يتغيّر مع الخدمة ومع المخزون. - أنشئ التفعيل بـ
POST /api/v1/activationsمع جسم JSON هو{"service": "<id>", "country": "cz"}. تعيد الاستجابة معرّف التفعيل والرقم الذي تكتبه في نموذج التسجيل الذي تختبره. - انتظر الرمز عبر Webhook أو بقراءة
GET /api/v1/activations/{id}على فترات معتدلة. - إذا أُلغي الاختبار، حرّر الرقم بـ
POST /api/v1/activations/{id}/cancelليعود المبلغ المحجوز إلى المحفظة فورًا.
استدعاء GET /api/v1/balance قبل بدء مجموعة اختبارات كبيرة وسيلة رخيصة للفشل مبكرًا عند انخفاض رصيد المحفظة. المرجع الكامل في الوثائق.
كيف أتحقق من Webhooks لتفعيلات +420؟
تُغنيك Webhooks عن الاستعلام الدوري وتناسب مشغّلات الاختبار المتوازية. وجّه أحد نقاط النهاية لديك (تسمح وحدة تحكم المطوّرين بـ 5 لكل حساب) إلى المسار التشيكي واشترك في activation.sms_received وactivation.expired وactivation.cancelled.
يحمل كل طلب ترويسة X-OTPRoute-Signature بالصيغة t=<unix>,v1=<hex>. أعد بناء السلسلة <t>.<raw body> من بايتات الطلب كما وصلت دون تعديل، واحسب HMAC-SHA256 بسرّ نقطة النهاية تلك، وقارن الناتج مع v1 بمقارنة ثابتة الزمن، وتجاهل أي طلب يكون طابعه الزمني أقدم من أن يكون تسليمًا حديثًا. يشرح دليلنا حول تأمين Webhooks لرموز OTP بـ HMAC معالجًا كاملًا سطرًا بسطر.
تعامل مع الأحداث على أنها مفتاحها معرّف التفعيل واجعل المعالج متساوي الأثر (idempotent): فالتسليم المعاد يجب أن يجد التفعيل مُعلَّمًا بالاكتمال فيعيد النجاح ببساطة. ويظل الاستعلام الدوري عبر GET /api/v1/activations/{id} بديلًا صالحًا للنصوص التي تعمل حيث لا تتوفر نقطة نهاية عامة.
ما الخدمات التي يمكنها إرسال رموز إلى الأرقام التشيكية؟
يغطي المسار التشيكي حاليًا أكثر من 1,700 خدمة. ومن الأسماء الشائعة في أحدث لقطة: WhatsApp وTelegram وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وMicrosoft & Outlook وLinkedIn وDiscord وUber وAirbnb وSignal وViber وChatGPT (OpenAI).
هذه القائمة ليست ثابتة. فالمخزون يتحرك على مدار اليوم، لذا ينبغي أن تقرأ شيفرتك الإتاحة من الواجهة وقت التشغيل لا من جدول مكتوب يدويًا. وإن غابت خدمة تحتاجها في لحظة ما فقد تعود لاحقًا، أو قد يناسب حالة الاختبار مسار مجاور في وسط أوروبا.
كيف يُخزَّن رقم التحقق التشيكي ويُحلَّل؟
الترقيم التشيكي مغلق: الأرقام الوطنية من تسعة أرقام ولا توجد بادئة خط رئيسي، فلا يختلف الشكل المحلي عن الدولي إلا بوجود +420 في المقدمة. وهذا يجعل التوحيد أبسط منه في أسواق كثيرة، لكن النماذج قد تستقبل مسافات أو بادئة دولية 00420 أو الأرقام التسعة وحدها. أزل الفواصل، وحوّل 00 إلى +، وأضف +420 عند غيابها، ثم خزّن الناتج بصيغة E.164.
تصل الرموز من التطبيقات الموجهة للتشيك غالبًا بالتشيكية أو الإنجليزية. والنص التشيكي يحتوي علامات تشكيل مثل háček وčárka، وبعض المرسلين يحذفونها ليبقى النص ضمن مجموعة أحرف بسيطة، لذا ينبغي أن يبحث المحلل عن مجموعة الأرقام لا أن يطابق جملة كاملة.
تستخدم الفرق رقم +420 للاختبار عند إطلاق منتج للعملاء التشيك، أو لفحص نصوص الإعداد الأولي بالتشيكية، أو للتأكد من أن مسار تسجيل إقليمي يقبل أرقامًا بلا صفر بادئ. وتلخّص صفحة اختبار الجودة كيف تنظّم الفرق هذه التشغيلات.
ماذا يجب أن يحدث حين لا يصل الرمز التشيكي؟
بعض الخدمات ترفض الأرقام الافتراضية، وبعض المسارات أبطأ في ساعات معينة. والرمز الفائت لا يكلّفك شيئًا: إن لم تصل أي رسالة خلال نافذة الـ 20 دقيقة، أو ألغيت قبلها، يعود المبلغ كاملًا إلى المحفظة تلقائيًا.
- دع النافذة تنتهِ قبل الحكم بأن المحاولة فشلت.
- تحقق مما إذا كانت الخدمة التي تختبرها تقبل الأرقام الافتراضية أصلًا.
- أعد المحاولة لاحقًا، أو جرّب مسار بلد آخر تدعمه الخدمة.
- باعد بين المحاولات؛ فإعادة الطلب في حلقة متلاحقة تستهلك حد الطلبات ونادرًا ما تفيد.
- سجّل معرّف التفعيل مع كل إخفاق لتظهر الأنماط عبر التشغيلات.
هل يستطيع غير المطوّرين استخدام مسار +420 من لوحة التحكم؟
نعم. بعد أن تسجّل بالبريد الإلكتروني ورمز بريدي من 6 أرقام (أو بتسجيل الدخول عبر Google)، افتح OTP Gateway، واختر الخدمة وجمهورية التشيك، وتحقق من السعر المعروض، ثم اطلب. يظهر رقم التحقق التشيكي فورًا؛ الصقه في التطبيق، ويظهر الرمز على الشاشة نفسها حين يصل. والإلغاء من لوحة التحكم يعيد المبلغ إلى المحفظة بالطريقة نفسها كاستدعاء الواجهة.
هل يوجد رقم تشيكي طويل الأمد، وكيف تتم الفوترة؟
لا يوجد اليوم رقم تشيكي طويل الأمد بالخدمة الذاتية. الأرقام المخصصة منتج للولايات المتحدة وكندا يبدأ من $1.95/month، ويشمل الرسائل الواردة والصادرة والاتصال من المتصفح؛ راجع الأرقام الافتراضية للتفاصيل. وإذا احتاج فريقك إلى خط +420 دائم فراسل [email protected] واسأل، مع العلم أن الإتاحة تتوقف على القواعد المحلية وليست موعودة.
الفوترة محفظة واحدة مسبقة الدفع بالدولار الأمريكي بلا رسوم شهرية ولا خطة لتختارها. يُضاف الرصيد بالبطاقة أو بعملتي USDT/USDC، وتُرسل بعد كل شحن فاتورة PDF بالبريد. ولأعمال التكامل يمكن عند الطلب تحويل حساب التطوير إلى وضع sandbox لتُجرِّب أرقام ورموز محاكاة المسار كله دون إنفاق رصيد المحفظة. كما يتوفر تسجيل دخول بخطوتين عبر TOTP للحساب نفسه.
الأسئلة الشائعة
هل أستطيع اختبار مسار التسجيل التشيكي في تطبيقي دون شريحة تشيكية؟
نعم. اطلب رقم +420 من OTP Gateway للخدمة التي تختبرها، وأدخله في تطبيقك، واقرأ الرمز من لوحة التحكم أو الواجهة البرمجية أو Webhook.
ما معرّف جمهورية التشيك في واجهة OTP Route البرمجية؟
استخدم cz في الحقل country ضمن POST /api/v1/activations وفي استعلامات الأسعار.
كم يكلّف رمز تحقق تشيكي؟
تبدأ الرموز من $0.20 للرمز، ويعيد GET /api/v1/prices السعر الدقيق لكل خدمة ويُعرض قبل أن تطلب. لا تدفع إلا إذا وصل الرمز.
هل تحتاج الأرقام التشيكية إلى صفر بادئ؟
لا. لا توجد بادئة خط رئيسي في التشيك، فخزّنها بصيغة +420 متبوعة بالأرقام الوطنية التسعة.
كم يبقى تفعيل +420 مفتوحًا؟
عشرون دقيقة. إن لم يصل شيء خلال هذه المدة ينتهي التفعيل ويُردّ المبلغ إلى المحفظة كاملًا.
هل يصلح توجيه OTP إلى التشيك لإنشاء حسابات بالجملة؟
لا. OTP Route مخصصة لاختبار منتجك وتشغيل حساباتك المشروعة. اربط كل تفعيل +420 بمنتجك أو حسابك، وفق شروط كل خدمة وسياسة الاستخدام المقبول في OTP Route.
هل يمكنني الاحتفاظ بالرقم التشيكي نفسه لعمليات دخول لاحقة؟
ليس كمنتج بالخدمة الذاتية. الأرقام المخصصة طويلة الأمد موجودة في الولايات المتحدة وكندا فقط، ويمكنك مراسلة الدعم للسؤال عن أسواق أخرى.
أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.