الخطوة 1: الاشتراك وتسجيل الدخول
- انتقل إلى الاشتراك في مركز الرسائل
- قم بإنشاء حسابك المجاني
- ستحصل على الفور على 1,000 رصيد مجاني لاختبار OTPs
الخطوة 2: تكامل API (المطورون، التجميع!)
لقد جعلنا هذا الأمر بسيطًا للغاية لدرجة أنك ستعتقد أنه غش. لا تقلق، لدينا مقتطفات شفرة جاهزة حتى تتمكن من تخطي النموذج المعياري والانتقال مباشرة إلى الاختبار.
لست من محبي قراءة التعليمات البرمجية؟ لدينا فيديو تعليمي يرشدك خطوة بخطوة.
معلمة API للتحقق الآن
يجب إرسال المعلمات التالية أثناء استخدام واجهات برمجة تطبيقات VerifyNow.
بقية عناوين URL الأساسية لواجهة برمجة التطبيقات
يجب أن تكون جميع نقاط نهاية Platform API أدناه مسبوقة بعنوان URL التالي:
https://cpaas.messagecentral.comإنشاء رمز
عند استخدام واجهة برمجة تطبيقات التحقق من الرسائل القصيرة الخاصة بـ Verify Now لإرسال رموز التحقق عبر الرسائل القصيرة، يجب أن تكون المكالمة الأولية إلى واجهة برمجة تطبيقات إنشاء الرمز المميز.
تقوم واجهة برمجة التطبيقات هذه بإرجاع رمز مميز يجب تضمينه في جميع المكالمات اللاحقة. يلزم وجود رمز مصادقة للتحقق من صحة المستخدم ويجب تضمينه في قسم العنوان لكل طلب.
مسار عنوان URL للطلب:
/auth/v1/authentication/tokencURL
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}أرسل OTP
لإرسال OTP على رقم هاتف محمول أدناه هي معاملات الطلب. رمز المصادقة مطلوب لإرسال OTP الذي تم إنشاؤه بواسطة واجهة برمجة تطبيقات الرمز المميز التي تم إنشاؤها (والتي يمكنك العثور عليها أعلاه في قسم المقدمة).
مسار عنوان URL للطلب:
ستؤدي الاستجابة الناجحة إلى إرجاع رمز الحالة 200.
/verification/v3/sendمعاملات عنوان URL للطلب:
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/- للحصول على دعم متعدد اللغات
- افتراضيًا هي اللغة الإنجليزية
- في الوقت الحالي نحن ندعم اللغة الإنجليزية فقط
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}رموز الاستجابة
المساعدة والدعم
للحصول على دعم التنفيذ وأي ملاحظات، يرجى التواصل معنا على: support@messagecentral.com

أسئلة متكررة
كيف أقوم بدمج رسالة نصية 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 بإعادة المحاولة تلقائيًا ويمكنه توصيل النصائح عبر الواتس آب في حالة تأخر تسليم النص، مما يضمن استمرار التحقق من المستخدمين.
