ReOTP.
API/2. Kontrola stavu ověření
1 min čtení

2. Kontrola stavu ověření

Dotaz na stav aktuální ověřovací relace.

Jakmile zahájíte proces ověření a získáte requestId, vaše aplikace musí v reálném čase naslouchat (SSE - Server-Sent Events) stavu relace, aby zjistila, zda klient zprávu úspěšně odeslal.

Plán A: Mechanismus fungování (SSE - nejrychlejší):

  • Vytvořte připojení EventSource k určenému koncovému bodu pro udržení trvalého spojení.
  • Jakmile získáte stav "VERIFIED", okamžitě ukončete spojení a přihlaste uživatele.

Alternativy (Fallbacks):

  • Plán B (Polling): Pokud vaše hostingové prostředí nepodporuje SSE, můžete použít tradiční dotazování pomocí GET požadavku na /api/verify/status?id=... každé 3 sekundy.
  • Plán C (Webhooks): Můžete se spolehnout na automatická oznámení z našich serverů přímo na váš server. Více informací naleznete v sekci Webhooks.

Vracené stavy (Session States):

  • PENDING: Klient zprávu ještě neodeslal. Pokračujte v naslouchání.
  • VERIFIED: Zpráva byla odeslána a číslo bylo úspěšně ověřeno.
  • EXPIRED: Platnost vypršela (maximálně po 2 minutách).
Integrační kód (SDK)
curl -N https://[your-domain.com]/api/verify/stream?id=YOUR_REQUEST_ID

Interaktivní API Playground

Vyzkoušejte si odesílání ověřovacích požadavků přímo a vygenerujte si integrační kód ve vašem preferovaném programovacím jazyce.

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