ReOTP.
API/2. Controllo dello stato della verifica
1 min di lettura

2. Controllo dello stato della verifica

Verifica lo stato della sessione di verifica corrente.

Una volta avviato il processo di verifica e ottenuto l'ID requestId, la tua applicazione deve ascoltare in tempo reale (tramite SSE - Server-Sent Events) lo stato della sessione per verificare se il cliente ha inviato il messaggio con successo o meno.

Piano A: Meccanismo operativo (SSE - Il più veloce):

  • Crea una connessione EventSource verso l'endpoint specificato per rimanere in contatto costante.
  • Non appena ottieni lo stato "VERIFIED", chiudi immediatamente la connessione e registra l'accesso dell'utente con successo.

Alternative di ascolto (Fallbacks):

  • Piano B (Polling): Se il tuo ambiente di hosting non supporta le SSE, puoi effettuare query tradizionali eseguendo una richiesta GET a /api/verify/status?id=... ogni 3 secondi.
  • Piano C (Webhooks): Puoi fare affidamento sulle notifiche automatiche dai nostri server direttamente al tuo server. Scopri di più nella sezione Webhooks.

Stati della sessione restituiti:

  • PENDING: Il cliente non ha ancora inviato il messaggio. Continua l'ascolto.
  • VERIFIED: Il messaggio è stato inviato e il numero è stato verificato con successo.
  • EXPIRED: Scaduto (dopo un massimo di 2 minuti).
Codice di integrazione (SDK)
curl -N https://reotp.com/api/verify/stream?id=YOUR_REQUEST_ID

Testa l'API interattiva diretta (Interactive API Playground)

Prova a inviare richieste di verifica direttamente e genera frammenti di codice di integrazione nel tuo linguaggio di programmazione preferito.

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