2. فحص حالة التحقق

الاستعلام عن حالة جلسة التحقق الحالية.

بمجرد بدء عملية التحقق وحصولك على المعرف requestId، يجب على تطبيقك الاستعلام بشكل دوري (Polling) عن حالة الجلسة لمعرفة ما إذا قام العميل بإرسال الرسالة بنجاح أم لا.

آلية العمل (Polling):

قم بإجراء طلب GET إلى نقطة النهاية الموضحة كل 3 ثوانٍ.

بمجرد الحصول على الحالة "VERIFIED"، قم بوقف الاستعلام فوراً وسجّل دخول المستخدم بنجاح.

الحالات المرتجعة (Session States):

PENDING: العميل لم يرسل الرسالة بعد. استمر في الاستعلام.

VERIFIED: تم إرسال الرسالة والتحقق من الرقم بنجاح.

EXPIRED: انتهت الصلاحية (بعد 5 دقائق من استيقاظ السيرفر كحد أقصى).

كود التوثيق البرمجي (SDKs)

curl -X GET https://[your-domain.com]/api/verify/status?id=YOUR_REQUEST_ID

اختبار الـ API التفاعلي المباشر (Interactive API Playground)

قم بتجربة إرسال طلبات التحقق مباشرة وتوليد أكواد الـ Integration باللغة البرمجية التي تفضلها.

مفتاح الـ API Key الخاص بك

رقم هاتف الاختبار

وسيلة التحقق

curl -X POST https://reotp.com/api/verify/init \
  -H "Authorization: Bearer 15a1c1c7-ed05-40df-b7c3-69c327542a07" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "201000000000",
    "method": "WHATSAPP"
  }'

المقال السابق1. طلب الروابط في الخلفية (Zero-Delay)

المقال التاليالإشعارات التلقائية (Webhooks)