واجهة البرمجة/2. فحص حالة التحقق
1 دقيقة قراءة
2. فحص حالة التحقق
الاستعلام عن حالة جلسة التحقق الحالية.
بمجرد بدء عملية التحقق وحصولك على المعرف requestId، يجب على تطبيقك الاستماع بشكل لحظي (SSE (Server-Sent Events)) لحالة الجلسة لمعرفة ما إذا قام العميل بإرسال الرسالة بنجاح أم لا.
الخطة أ: آلية العمل (SSE - الأسرع):
- قم بإنشاء اتصال
EventSourceإلى نقطة النهاية الموضحة للبقاء على اتصال مستمر.
- بمجرد الحصول على الحالة
"VERIFIED"، قم بإنهاء الاتصال فوراً وسجّل دخول المستخدم بنجاح.
بدائل الاستماع (Fallbacks):
- الخطة ب (Polling): إذا كانت بيئة الاستضافة الخاصة بك لا تدعم الـ SSE، يمكنك الاستعلام التقليدي عبر إجراء طلب
GETإلى/api/verify/status?id=...كل 3 ثوانٍ.
- الخطة ج (Webhooks): يمكنك الاعتماد على الإشعارات التلقائية من خوادمنا إلى خادمك المباشر. اقرأ المزيد في قسم Webhooks.
الحالات المرتجعة (Session States):
PENDING: العميل لم يرسل الرسالة بعد. استمر في الاستماع.
VERIFIED: تم إرسال الرسالة والتحقق من الرقم بنجاح.
EXPIRED: انتهت الصلاحية (بعد دقيقتين كحد أقصى).
كود التكامل (SDKs)
اختبار الـ API التفاعلي المباشر (Interactive API Playground)
قم بتجربة إرسال طلبات التحقق مباشرة وتوليد أكواد الـ Integration باللغة البرمجية التي تفضلها.
curl -X POST https://reotp.com/api/verify/init \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phoneNumber": "201000000000",
"method": "WHATSAPP"
}'