ReOTP.
API/2. Sprawdzanie statusu weryfikacji
1 min. czytania

2. Sprawdzanie statusu weryfikacji

Zapytanie o status bieżącej sesji weryfikacyjnej.

Po rozpoczęciu procesu weryfikacji i uzyskaniu requestId, Twoja aplikacja powinna nasłuchiwać w czasie rzeczywistym (SSE - Server-Sent Events) statusu sesji, aby sprawdzić, czy klient pomyślnie wysłał wiadomość.

Plan A: Mechanizm działania (SSE - najszybszy):

  • Utwórz połączenie EventSource do wskazanego punktu końcowego, aby utrzymać stałe połączenie.
  • Po uzyskaniu statusu "VERIFIED", natychmiast zakończ połączenie i zaloguj użytkownika.

Alternatywy (Fallbacks):

  • Plan B (Polling): Jeśli Twoje środowisko hostingowe nie obsługuje SSE, możesz użyć tradycyjnego odpytywania, wykonując żądanie GET do /api/verify/status?id=... co 3 sekundy.
  • Plan C (Webhooks): Możesz polegać na automatycznych powiadomieniach z naszych serwerów bezpośrednio do Twojego serwera. Dowiedz się więcej w sekcji Webhooks.

Zwracane stany (Session States):

  • PENDING: Klient jeszcze nie wysłał wiadomości. Kontynuuj nasłuchiwanie.
  • VERIFIED: Wiadomość została wysłana, a numer pomyślnie zweryfikowany.
  • EXPIRED: Sesja wygasła (maksymalnie po 2 minutach).
Kod integracyjny (SDK)
curl -N https://reotp.com/api/verify/stream?id=YOUR_REQUEST_ID

Interaktywny plac zabaw API (Interactive API Playground)

Wypróbuj wysyłanie żądań weryfikacyjnych na żywo i wygeneruj kod integracyjny w preferowanym języku programowania.

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"
  }'