ReOTP.
API/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: Термін дії закінчився (максимум через 2 хвилини).
Код інтеграції (SDKs)
curl -N https://[your-domain.com]/api/verify/stream?id=YOUR_REQUEST_ID

Інтерактивний 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"
  }'