رابط برنامهنویسی (API)/۲. بررسی وضعیت تأیید
1 دقیقه خواندن
۲. بررسی وضعیت تأیید
استعلام از وضعیت جلسه تأیید فعلی.
به محض شروع فرآیند تأیید و دریافت شناسه requestId، برنامه شما باید به صورت لحظهای (SSE (Server-Sent Events)) به وضعیت جلسه گوش دهد تا متوجه شود آیا مشتری پیام را با موفقیت ارسال کرده است یا خیر.
طرح الف: نحوه کار (SSE - سریعترین روش):
- یک اتصال
EventSourceبه اندپوینت مشخصشده ایجاد کنید تا در اتصال مداوم بمانید.
- به محض دریافت وضعیت
"VERIFIED"، اتصال را بلافاصله قطع کرده و ورود کاربر را با موفقیت ثبت کنید.
روشهای جایگزین (Fallbacks):
- طرح ب (Polling): اگر محیط هاستینگ شما از SSE پشتیبانی نمیکند، میتوانید هر ۳ ثانیه یکبار با ارسال درخواست
GETبه/api/verify/status?id=...استعلام بگیرید.
- طرح ج (Webhooks): میتوانید به اعلانهای خودکار از سرورهای ما به سرور مستقیم خود تکیه کنید. در بخش Webhooks بیشتر بخوانید.
وضعیتهای برگشتی (Session States):
PENDING: مشتری هنوز پیام را ارسال نکرده است. به گوش دادن ادامه دهید.
VERIFIED: پیام ارسال شده و شماره با موفقیت تأیید شد.
EXPIRED: منقضی شده است (حداکثر پس از ۲ دقیقه).
کد ادغام (SDKها)
محیط تست تعاملی API (Interactive API Playground)
ارسال درخواستهای احراز هویت را به صورت زنده تجربه کنید و کدهای یکپارچهسازی را به زبان برنامهنویسی دلخواه خود دریافت کنید.
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"
}'