مرحبًا بك في VerifyNow - دليل الإعداد السريع

ستساعدك هذه الصفحة على الانتقال من التسجيل ← تكامل API ← OTPs المباشرة في أقل من 15 دقيقة.

العفر، الجزء الأول من بيت الرفوف
tick-icon

الخطوة 1: الاشتراك وتسجيل الدخول

  1. انتقل إلى الاشتراك في مركز الرسائل
  2. قم بإنشاء حسابك المجاني
  3. ستحصل على الفور على 1,000 رصيد مجاني لاختبار OTPs
📌 نصيحة: استخدم هذه الاعتمادات لإرسال OTP للاختبار على الفور قبل بدء البث المباشر.
tick-icon

الخطوة 2: تكامل API (المطورون، التجميع!)

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

لست من محبي قراءة التعليمات البرمجية؟ لدينا فيديو تعليمي يرشدك خطوة بخطوة.

دمج واجهات برمجة تطبيقات التحقق من الرسائل القصيرة (V3) مع Message Central

🔐 تعرف على كيفية مصادقة المستخدمين باستخدام واجهات برمجة تطبيقات SMS OTP باستخدام Message Central في NodeJS و Python و Java و PHP و Ruby و C #!

معلمة API للتحقق الآن

يجب إرسال المعلمات التالية أثناء استخدام واجهات برمجة تطبيقات VerifyNow.

المعلمة API
النوع
القيمة
نوع التدفق
سلسلة
الرسائل القصيرة/واتس اب/RCS/SAUTH
نوع
سلسلة
قمة

بقية عناوين URL الأساسية لواجهة برمجة التطبيقات

يجب أن تكون جميع نقاط نهاية Platform API أدناه مسبوقة بعنوان URL التالي:

https://cpaas.messagecentral.com

إنشاء رمز

عند استخدام واجهة برمجة تطبيقات التحقق من الرسائل القصيرة الخاصة بـ Verify Now لإرسال رموز التحقق عبر الرسائل القصيرة، يجب أن تكون المكالمة الأولية إلى واجهة برمجة تطبيقات إنشاء الرمز المميز.

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

الحقل
النوع
إلزامي؟
وصف
معرف العميل
سلسلة
نعم
معرف العميل (تحتاج إلى سجل للحصول على معرف العميل الخاص بك)
بلد
سلسلة
كلا
رمز البلد لإرسال OTP إليه
البريد الإلكتروني
سلسلة
كلا
البريد الإلكتروني
مفتاح
سلسلة
نعم
كلمة مرور Base-64 المشفرة
نطاق
سلسلة
كلا
استخدم «جديد» لأول مرة

مسار عنوان URL للطلب:

/auth/v1/authentication/token

cURL

1curl --location 'https://cpaas.messagecentral.com/auth/v1/authentication/token? 
2customerId=%3CCustomerId%3E&key=%3CBase64%20Encrypted%20password%3E&scope=NEW&country=91
3&email=test%40messagecentral.com' \
4--header 'accept: */*'

ملاحظة: لتحويل أمر cURL إلى كود باستخدام Postman، افتح Postman، واستورد الأمر cURL عبر زر «استيراد»، ثم قم بإنشاء الكود بلغتك المفضلة بالنقر فوق الزر «Code» على الجانب الأيمن من الطلب.

الاستجابة: جسون

1{
2  "status": Integer,
3  "token": "String"
4}

اغتنم الفرصة

إذا كنت مطورًا أو وكالة تطوير ويب، شارك معنا لتسريع أرباحك.

كن شريكًا
ملف css

أرسل OTP

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

المعلمة API
النوع
إلزامي؟
رمز المصادقة
سلسلة
نعم

مسار عنوان URL للطلب:

ستؤدي الاستجابة الناجحة إلى إرجاع رمز الحالة 200.

/verification/v3/send

معاملات عنوان URL للطلب:

الحقل
النوع
إلزامي؟
وصف
معرف العميل
سلسلة
نعم
رمز البلد
الطول العلوي
عدد صحيح
كلا
أرسل رقمًا بين 4 و 8. القيمة الافتراضية هي 4
رقم الهاتف المحمول
سلسلة
نعم
رقم الهاتف المحمول للنص المفرد
نوع التدفق
سلسلة
نعم
نرسل OTP باستخدام وسائط متعددة مثل الرسائل القصيرة وWhatsApp والبريد الإلكتروني وما إلى ذلك، في الوقت الحالي، استخدم إما SMS أو WhatsApp

cURL

1curl --location --request POST 'https://cpaas.messagecentral.com/verification/v3/send? 
2countryCode=91&flowType=SMS&mobileNumber=9999999999' \
3--header 'authToken: 
4eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJDLTMzNDMyQTVGNDIGNzQwNCI6ImIhdCI6MTcxMjExOTA0MCwiZXhwIjo'

ملاحظة: لتحويل أمر cURL إلى كود باستخدام Postman، افتح Postman، واستورد الأمر cURL عبر زر «استيراد»، ثم قم بإنشاء الكود بلغتك المفضلة بالنقر فوق الزر «Code» على الجانب الأيمن من الطلب. يمكنك تغيير أساس FlowType للقناة التي تختارها.

الاستجابة: جسون

1{
2  "responseCode": 200,
3  "message": "SUCCESS",
4  "data": {
5    "verificationId": "xxxx",
6    "mobileNumber": "xxxx",
7    "responseCode": "200",
8    "errorMessage": null,
9    "timeout": "60",
10    "smCLI": null,
11    "transactionId": "xxxx"
12  }
13}

تحقق من صحة OTP

طريقة ValidateOTP هي نقطة نهاية REST API للتحقق من كلمة المرور لمرة واحدة (OTP) للعملاء.

عنوان الطلب
النوع
إلزامي؟
رمز المصادقة
سلسلة
نعم

مسار عنوان URL للطلب:

ستؤدي الاستجابة الناجحة إلى إرجاع رمز الحالة 200.

/verification/v3/validateOtp/
الحقل
النوع
إلزامي؟
وصف
معرف التحقق
طويل
نعم
معرف التحقق من استجابة /send api
الشفرة
سلسلة
نعم
قمة
لاهث
سلسلة
كلا
رقم الهاتف المحمول للنص المفرد
نوع التدفق
سلسلة
نعم
  • للحصول على دعم متعدد اللغات
  • افتراضيًا هي اللغة الإنجليزية
  • في الوقت الحالي نحن ندعم اللغة الإنجليزية فقط

cURL

1curl --location 'https://cpaas.messagecentral.com/verification/v3/validateOtp? 
2&verificationId=2949&code=1476' \
3--header 'authToken: 
4eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJDLTMzNDMyQTVGNDIGNzQwNCI6ImIhdCI6MTcxMjExOTA0MC'

ملاحظة: لتحويل أمر cURL إلى كود باستخدام Postman، افتح Postman، واستورد الأمر cURL عبر زر «استيراد»، ثم قم بإنشاء الكود بلغتك المفضلة بالنقر فوق الزر «Code» على الجانب الأيمن من الطلب.

الاستجابة: جسون

ستؤدي الاستجابة الناجحة إلى إرجاع رمز الحالة 200.

1{
2  "responseCode": 200,
3  "message": "SUCCESS",
4  "data": {
5    "verficationId": "xxxx",
6    "mobileNumber": "xxxx",
7    "responseCode": "200",
8    "errorMessage": null,
9    "verificationStatus": "VERIFICATION_COMPLETED",
10    "authToken": null,
11    "transactionId": "xxxx"
12  }
13}

رموز الاستجابة

الكود
نص العرض
200
نجاح
400
طلب سيء
409
مورد_مكرر
500
خطأ في الخادم
501
معرف_عميل غير صالح
505
معرف_تحقق غير صالح
506
الطلب موجود بالفعل
511
رمز بلد غير صالح
700
فشل التحقق
702
لم يتم تقديمه بشكل خاطئ
703
تم التحقق منه بالفعل
705
انتهت صلاحية التحقق
800
تم الوصول إلى الحد الأقصى

المساعدة والدعم

للحصول على دعم التنفيذ وأي ملاحظات، يرجى التواصل معنا على: support@messagecentral.com

API User Guide

تنزيل دليل المستخدم

احصل على وثائق API شاملة للتحقق الآن
قم بالتنزيل الآن

أسئلة متكررة

كيف أقوم بدمج رسالة نصية 2FA باستخدام OTP API؟

تقوم بدمج رسالة نصية 2FA عن طريق الاتصال بـ أفضل واجهة برمجة تطبيقات لإرسال رمز لمرة واحدة، ثم التحقق من إدخال المستخدم عبر نقطة نهاية التحقق. تتعامل واجهة برمجة التطبيقات مع إنشاء التعليمات البرمجية وانتهاء صلاحيتها وإعادة المحاولة والتسليم. منصات مثل توفر VerifyNow واجهات برمجة تطبيقات REST ومجموعات SDK الجاهزة للاستخدام لبدء البث المباشر مع 2FA OTPs بسرعة.

كيف يمكنني إرسال 2FA OTP عبر النص باستخدام واجهة برمجة تطبيقات REST؟

إلى أرسل 2FA TOPs عبر رسالة نصية، تستدعي الواجهة الخلفية واجهة برمجة تطبيقات REST مع رقم هاتف المستخدم ونوع التحقق. تقوم واجهة برمجة التطبيقات بإرسال OTP وإرجاع معرف التحقق. يقوم المستخدم بإرسال الرمز الذي تتحقق منه من خلال مكالمة API ثانية. تحقق الآن يدعم هذا التدفق خارج الصندوق.

ما مدى السرعة التي يجب أن تكون بها المصادقة الثنائية القائمة على النص في الولايات المتحدة؟

يجب أن يتم تسليم 2FA المستند إلى النص في الولايات المتحدة في الداخل من 1 إلى 2 ثانية للحصول على أفضل تجربة مستخدم. التسليم بعد 5 ثوانٍ يزيد من حالات الإنزال. تعتمد السرعة على تسجيل 10DLCوتوجيه الناقل وحمل حركة المرور. تحقق الآن يعمل على تحسين التوجيه للحفاظ على مستوى منخفض باستمرار قمة وقت الاستجابة للتسليم.

كيف يمكنني تحسين معدلات تسليم OTP النصية في الولايات المتحدة؟

تحسين التسليم باستخدام 10 دي إل سي- الأرقام المسجلة ونماذج OTP المعتمدة وتحديد المعدل ومنطق إعادة المحاولة. تجنب المحتوى الذي يثير الرسائل غير المرغوب فيها ورشقات ساعة الذروة. تؤدي إضافة قنوات احتياطية إلى تعزيز النجاح بشكل كبير. تحقق الآن يشمل عمليات إعادة المحاولة المضمنة والتراجع التلقائي لـ WhatsApp لتحقيق أقصى قدر من إكمال التحقق.

هل أحتاج إلى موافقة المستخدم لإرسال OTP نصية في الولايات المتحدة؟

نعم، موافقة المستخدم مطلوبة إرسال رسائل نصية عبر OTP في الولايات المتحدة تحت TCPA و FCC اللوائح، على الرغم من أن OTPs تعتبر رسائل معاملات ذات «موافقة صريحة مسبقة» أقل صرامة مقارنة بالرسائل القصيرة التسويقية. تحقق الآن يستخدم قوالب ومسارات متوافقة مع قواعد شركة النقل الأمريكية.

كيف يمكنني اختبار واجهات برمجة تطبيقات OTP النصية دون إرسال رسائل حقيقية؟

يمكنك نص اختبار واجهات برمجة تطبيقات OTP استخدام بيانات اعتماد sandbox أو الردود الساخرة أو اعتمادات الاختبار المحدودة. صندوق رمل يحاكي إرسال OTP والتحقق منهيتدفق y بدون تسليم حقيقي. تحقق الآن يوفر أيضًا ائتمانات اختبار مجانية حتى يتمكن المطورون من التحقق من التسليم في العالم الحقيقي ووقت الاستجابة قبل بدء البث المباشر.

ما هي رموز الخطأ الأكثر شيوعًا عند إرسال ملفات OTPs النصية؟

رموز خطأ OTP النصية الشائعة في الولايات المتحدة تتضمن 30034 (10DLC غير مسجل)، 30008 (تصفية البريد العشوائي للناقل)، 30023/30024 (تحديد المعدل)، و 30007 (ازدحام الناقل). يساعد فهم هذه الرموز في تصحيح مشكلات التسليم بسرعة. تحقق الآن يعرض تشخيصات واضحة لكل فشل.

ماذا يعني رمز الخطأ 30034 في تسليم OTP النصي؟

رمز الخطأ 30034 يعني أنه تم حظر رسائلك النصية لأن رقمك أو حملتك غير مسجلة في 10DLC. ترفض شركات النقل الأمريكية بصمت حركة A2P غير المسجلة. أصلح ذلك عن طريق تسجيل علامتك التجارية وحالة استخدام OTP أو الاستخدام تحقق الآن إعداد 10DLC المعتمد مسبقًا.

لماذا أتلقى رمز الخطأ 30008 على الرغم من الموافقة على رسالتي؟

خطأ 30008 يشير إلى تصفية البريد العشوائي لشركة الاتصالات، وليس رفض القالب. تشمل الأسباب جميع نصوص CAPS أو الرموز التعبيرية أو عناوين URL المختصرة أو الصياغة الترويجية. حتى الرسائل المعتمدة يمكن تصفيتها. استخدام قوالب OTP النظيفة والمعتمدة مسبقًا (مثل تلك المقدمة من تحقق الآن) يساعد على تجنب فلاتر البريد العشوائي لشركة الاتصالات.

كيف يمكنني إصلاح حالات فشل OTP الناتجة عن اختناق شركة الاتصالات (30023/30024)؟

يحدث اختناق الناقل عندما يتجاوز حجم الرسالة المعدلات المسموح بها. يمكنك إصلاح ذلك من خلال تطبيق حدود الأسعار ووضع رسائل OTP في قائمة الانتظار وتسخين الأرقام وتوزيع حركة المرور عبر الأرقام المسجلة. تحقق الآن يدير الإنتاجية تلقائيًا ويعيد المحاولة لمنع الاختناق أثناء ارتفاع حركة المرور.

ماذا أفعل عندما تفشل OTPs بسبب ازدحام الناقل (30007)؟

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

هل أنت جاهز للبدء؟

قم بحماية حسابات المستخدمين الخاصة بك وبناء الثقة مع عملائك باستخدام التحقق من الرسائل القصيرة. جرب التحقق الآن بدون أي بطاقة ائتمان.