مسارك كمطوّر إلى رموز التحقق السويسرية (+41)

ما الطلبات التي تعيد رمزاً سويسرياً عبر واجهة API؟

الواجهة البرمجية الخاصة بسويسرا هي نفسها الصغيرة والمستخدمة لكل بلد، مع المعرّف ch للبلد. صادِق باستخدام مفتاح Bearer (يبدأ بالبادئة or_live_) تنشئه من Developer console؛ ويمكن للحساب الواحد أن يحمل حتى 10 مفاتيح.

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

ضع GET /api/v1/balance في خطوة تهيئة مجموعة الاختبارات لديك. حد الطلبات 300 طلب في الدقيقة لكل حساب، وهو يكفي بسهولة لعدة مهام متزامنة تستعلم بفاصل زمني مريح. مرجع نقاط الوصول: التوثيق.

الاستعلام الدوري أم webhooks لتفعيلات +41؟

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

يتيح لك OTP Route تسجيل ما يصل إلى خمس نقاط وصول؛ اشترك في كل منها بالأحداث activation.sms_received وactivation.expired وactivation.cancelled. تحقق من كل رسالة واردة قبل الوثوق بها: خذ الجزأين t وv1 من X-OTPRoute-Signature، واحسب HMAC-SHA256 على "<t>.<raw body>" بسر نقطة الوصول، وقارن في زمن ثابت، وارفض الطوابع الزمنية الخارجة عن هامش تسامح قصير. اجعل المعالجة مبنية على معرّف التفعيل بحيث يكون إعادة إرسال الرسالة بلا أثر.

ولمعالجة أعمق لفحص التوقيعات، راجع تأمين webhooks الخاصة بـ OTP باستخدام HMAC.

كيف ينبغي أن يظهر الرقم السويسري في قاعدة بياناتك؟

محلياً تبدأ الأرقام السويسرية ببادئة الخط 0، فمثلاً يُكتب رقم الجوال 079 123 45 67. أما دولياً فيختفي هذا الصفر: صيغة E.164 هي +41 79 123 45 67، أي تسعة أرقام بعد رمز البلد. وتقع نطاقات الجوال في الكتلة 07x. خزّن السلسلة القياسية +41… ولا تنسّق إلا للعرض، وإلا ينكسر إزالة التكرار والبحث حين تستخدم صيغة 079 وأخرى +4179.

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

تُجري الفرق الاختبار هنا قبل إطلاق منتج مالي أو تجارة إلكترونية في السوق السويسرية، أو عند دعم موظفين يديرون حسابات الشركة من جنيف أو بازل، أو عند التحقق من تدفقات عابرة للحدود تمر أيضاً عبر ليختنشتاين التي لها رمزها الخاص +423.

الخدمات التي يمكنك التحقق منها برقم تحقق سويسري

تعرض اللقطة الحالية للمعرّف ch ما يلي: Google (Gmail & YouTube) وMicrosoft & Outlook وLinkedIn وWhatsApp وTelegram وSignal وUber وAirbnb وAmazon وeBay وNetflix وDiscord وChatGPT (OpenAI) وClaude وغيرها. وإجمالاً تضم سويسرا أكثر من 1,700 خدمة على OTP Gateway.

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

استكشاف أخطاء تفعيل سويسري يبقى فارغاً

عندما لا يستقبل رقم +41 أي شيء، مرّ على هذه النقاط قبل أن تلمس شيفرتك:

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

يشرح المقال عن توجيه OTP حسب البلد لماذا قد يتصرف التطبيق نفسه بشكل مختلف من مسار بلد إلى آخر.

هل يوجد رقم سويسري طويل الأمد؟

ليس كمنتج بالخدمة الذاتية. ففي سويسرا يقدّم OTP Route أرقاماً لمرة واحدة عبر OTP Gateway فقط.

أما الأرقام الافتراضية المخصصة (Dedicated Virtual Numbers)، وهي التي تحتفظ بها ما دامت تتجدد، فهي مقصورة على الولايات المتحدة وكندا وتبدأ من $1.95/month. وإذا كنت تحتاج تحديداً إلى خط سويسري دائم، فراسل [email protected] واشرح حالة الاستخدام؛ فالجواب يعتمد على القواعد المحلية ولا يمكن الوعد به مسبقاً.

المحفظة والفواتير وبيئة sandbox لتوجيه OTP السويسري

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

ولأعمال التكامل، اطلب تفعيل وضع sandbox على حساب التطوير. فهو يعيد أرقاماً ورموزاً محاكاة بحيث يمكن اختبار مسار واجهة SMS verification API كاملاً دون إنفاق أموال المحفظة. ولا تستخدم التفعيلات الحقيقية إلا لمنتجاتك وحساباتك أنت، ضمن شروط كل خدمة وسياسة الاستخدام المقبول (Acceptable Use Policy) في OTP Route. وتوضح صفحة حل اختبار الجودة QA كيف تدمج الفرق هذا في فحوصات الإصدار.

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

ما معرّف البلد الذي تستخدمه الواجهة لسويسرا؟

سويسرا هي ch. تحمل الطلبات السويسرية هذه القيمة المكوّنة من حرفين أينما كان مطلوباً معرّف بلد، بما في ذلك جسم طلب التفعيل.

هل يمكنني فحص تدفق تسجيل دخول سويسري دون شريحة سويسرية؟

نعم. رقم +41 للاختبار من OTP Gateway يستقبل الرمز، ثم تقرؤه في لوحة التحكم أو عبر الواجهة البرمجية.

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

لا. الصفر بادئة خط محلية؛ خزّن صيغة E.164 التي تبدأ بـ +41 متبوعة بتسعة أرقام.

بأي لغة ستصل رسالة التحقق السويسرية؟

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

كم تكلّف رسالة SMS OTP في سويسرا؟

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

ماذا يحدث لأموالي إذا لم يصل رمز؟

تعود تلقائياً إلى محفظتك عند إغلاق النافذة أو عند إلغائك للتفعيل.

هل تغطي الخدمة السويسرية ليختنشتاين؟

لا، فليختنشتاين رمز بلدها الخاص +423 وصفحتها الخاصة في قائمة البلدان، لذا اطلبها على حدة.

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