العربية
دليل يبدأ بالـ API لرموز التحقق السويدية +46
تستقبل OTP Route رموز التحقق السويدية (+46) عبر SMS على أرقام للاستخدام مرة واحدة من OTP Gateway، وتسلّم كل رمز إلى لوحة التحكم وإلى شيفرتك عبر webhooks موقّعة أو الاستعلام الدوري من REST. تدفع من $0.20 للرمز ولا تدفع إلا عند وصوله؛ والطلب الذي لا تصل فيه رسالة بعد 20 دقيقة يُردّ مبلغه تلقائيًا.
ما نقاط النهاية التي أستدعيها لاستقبال رمز OTP سويدي عبر SMS؟
ابدأ بمفتاح API من وحدة المطوّرين. تحمل المفاتيح البادئة or_live_ وتوضع في ترويسة Bearer مقابل https://otproute.com/api/v1؛ ويمكنك الاحتفاظ بما يصل إلى 10 منها، مما يسهّل الفصل بين CI وبيئة staging وجهاز المطوّر. معرّف السويد هو se.
- يعطيك
GET /api/v1/servicesوGET /api/v1/countriesالمعرّفات. خزّنها مؤقتًا لكل تشغيل. - يعيد
GET /api/v1/prices?country=se&service=discordسعر اليوم وتوفر ذلك الزوج. - ينشئ
POST /api/v1/activationsمع{"service": "discord", "country": "se"}الطلب ويعيد معرّف التفعيل ورقم +46. - يُدخل اختبارك الرقم في شاشة التحقق في المنتج.
- يصلك الرمز عبر webhook أو عبر
GET /api/v1/activations/{id}. - يحرّر
POST /api/v1/activations/{id}/cancelطلبًا لم يعد الاختبار بحاجة إليه.
واستدعاء GET /api/v1/balance قبل المجموعة يتيح للمهمة التوقف مبكرًا حين يكون الرصيد منخفضًا. السقف 300 طلب في الدقيقة، وهو كافٍ لفاصل استعلام دوري من بضع ثوانٍ. راجع دليل تكامل OTP API لشرح أوسع لواجهة التحقق عبر SMS هذه.
كيف أتحقق من webhook قبل الوثوق برمز +46؟
سجّل نقطة نهاية في وحدة المطوّرين (حتى 5 لكل حساب) واشترك في activation.sms_received وactivation.expired وactivation.cancelled.
يتضمن كل تسليم الترويسة X-OTPRoute-Signature: t=<unix>,v1=<hex>. ويجب أن يقوم معالجك بما يلي:
- أن يعيد بناء السلسلة
"<t>.<raw body>"من جسم الطلب كما وصل دون تعديل؛ - أن يحسب HMAC-SHA256 بسرّ نقطة النهاية تلك ويقارنه بـ
v1بمقارنة ثابتة الزمن؛ - أن يرفض الطوابع الزمنية خارج هامش قصير لمنع إعادة الإرسال؛
- أن يبني عمله على معرّف التفعيل، كي لا يُعالَج الرمز نفسه مرتين عند إعادة التسليم.
ويبقى الاستعلام الدوري بديلًا صالحًا حين يحجب جدار ناري الاستدعاءات الواردة. ويغطي مقال أمان webhook بـ HMAC الحالات الحدّية.
ما الخدمات التي يستطيع رقم +46 التحقق منها؟
يعرض المسار السويدي حاليًا أكثر من 1,700 خدمة. ومن الأمثلة الحالية WhatsApp وTelegram وDiscord وSnapchat وLinkedIn وMicrosoft & Outlook وGoogle (Gmail & YouTube) وUber وNetflix وAmazon وSignal وChatGPT (OpenAI) وClaude وeBay وX (Twitter).
تتحرك الأعداد والمخزون خلال اليوم، فدع نقطة الأسعار تحدد ما تطلبه اختباراتك بدل تثبيت قائمة في الشيفرة.
كيف تُوحَّد الأرقام السويدية وتُحلَّل؟
تستخدم السويد بادئة الخط 0. فالرقم المحمول المكتوب محليًا 07 متبوعًا بثماني خانات يصبح +46 7 وتلك الخانات الثماني بصيغة E.164، مع حذف الصفر. خزّن هذه الصيغة الدولية، وتأكد أن معالجة الإدخال تزيل المسافات والشرطات والصفر الأول قبل إضافة +46. ورقم +46 للاختبار مثال ثابت جيد لهذا الفحص تحديدًا، لأن السويديين كثيرًا ما يكتبون الصيغة المحلية بالعادة.
قد تتضمن قوالب الرسائل السويدية الأحرف å وä وö. فإن كان خط المعالجة لديك يسجّل الرسالة الخام، فتأكد أنه يتعامل مع نص Unicode بسلاسة، واستخرج الرمز بنمط الأرقام لا بعبارة إنجليزية مثل «your code is». عندئذٍ يعمل المحلّل نفسه سواء كتبت الخدمة بالسويدية أو الإنجليزية.
وتختبر الفرق هنا عند الإطلاق في دول الشمال الأوروبي، ولمراجعة النصوص السويدية في التسجيل، ولفرق الدعم الإقليمية التي تدير حسابات نيابةً عن الشركة.
هل يستطيع غير المطوّرين استخدام لوحة التحكم للسويد؟
نعم. اختر السويد وخدمة، وتحقق من السعر الحي، ثم أكّد. يظهر رقم +46 في قائمة الطلبات؛ الصقه في التطبيق، وسيظهر الرمز بجانبه حين ترسله الخدمة. يستخدم مديرو المنتجات وموظفو الدعم هذا المسار لفحص مسار واحد برقم تحقق سويدي دون لمس API. ويتطلب إعداد الحساب بريدًا إلكترونيًا ورمزًا من 6 خانات عند التسجيل.
لماذا قد لا يصل رمز +46، وماذا أفعل حينها؟
كل تفعيل مفتوح لمدة 20 دقيقة، ولا تدفع إلا إذا وصل الرمز. والطلبات المنتهية أو الملغاة يُردّ مبلغها كاملًا إلى المحفظة دون الحاجة إلى تذكرة.
إن غاب الرمز فامنح النافذة وقتها، ثم أعد المحاولة لاحقًا أو اختبر عبر مسار خدمة آخر. بعض الخدمات ترفض الأرقام الافتراضية، والرفض على شاشة التسجيل يعني عادةً ذلك لا خللًا في التسليم. تراجع بين المحاولات بدل إعادة الطلب في حلقة متلاحقة؛ فمنطق OTP routing الجيد يعتبر غياب الرمز إشارة إلى الانتظار أو التبديل لا إلى الإلحاح.
الخطوط المخصصة والمحفظة وsandbox لاختبار السويد
الرقم طويل الأمد بالخدمة الذاتية في السويد ليس جزءًا من OTP Route اليوم. الأرقام المخصصة متاحة في الولايات المتحدة وكندا فقط، بسعر يبدأ من $1.95/month؛ وللحصول على خط سويدي دائم راسل [email protected]، وسيخبرك الفريق إن كانت القواعد المحلية تسمح بذلك.
يتم التمويل عبر محفظة مسبقة الدفع بالدولار بلا رسوم شهرية، تُشحن بالبطاقة أو بعملات USDT/USDC، وتتبع كل شحنة فاتورة PDF. اطلب تحويل حساب تطوير إلى sandbox إن أردت أرقامًا ورموزًا محاكاة لـ CI. وتفاصيل التكاليف في صفحة الأسعار.
اختبر منتجاتك أنت فقط، والتزم بشروط كل خدمة، واتبع سياسة الاستخدام المقبول لدى OTP Route.
الأسئلة الشائعة
ما معرّف السويد في API الخاص بـ OTP Route؟
إنه se، ويُستخدم في سلسلة استعلام الأسعار وفي جسم التفعيل.
هل أخزّن الأرقام السويدية مع الصفر في أولها؟
لا. احذف صفر الخط واحفظ صيغة E.164 التي تبدأ بـ +46؛ ولا تعرض الصيغة المحلية إلا إن احتاجتها واجهتك.
هل أستطيع اختبار مسار التسجيل السويدي في تطبيقي دون شريحة سويدية؟
نعم. اطلب رقم +46 للخدمة، وأدخله في تطبيقك، واستلم الرمز عبر webhook أو الاستعلام الدوري أو لوحة التحكم.
هل ستعطّل الأحرف السويدية محلّل OTP لديّ؟
لا ينبغي ذلك إن طابقت الأرقام بدل الكلمات وتعاملت مع الرسالة على أنها نص Unicode.
كم يكلّف طلب +46 فاشل؟
لا شيء. فبلا رسالة SMS خلال 20 دقيقة، أو بعد الإلغاء، يعود المبلغ كاملًا إلى المحفظة.
هل أستطيع الحصول على رقم سويدي يبقى لي؟
ليس كمنتج بالخدمة الذاتية. الأرقام طويلة الأمد متاحة في الولايات المتحدة وكندا؛ راسل [email protected] للسؤال عن السويد.
كيف أجري اختبارات التكامل دون استخدام أموال حقيقية؟
اطلب وضع sandbox لحساب تطوير، فيعيد أرقامًا ورموزًا محاكاة من البداية إلى النهاية.
أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.