ReOTP.
API/2. Vérification de l'état de validation
2 min de lecture

2. Vérification de l'état de validation

Interroger l'état de la session de vérification actuelle.

Une fois la vérification lancée et l'identifiant requestId obtenu, votre application doit écouter en temps réel (SSE - Server-Sent Events) l'état de la session pour savoir si le client a envoyé le message avec succès.

Plan A : Mécanisme de fonctionnement (SSE - Le plus rapide) :

  • Créez une connexion EventSource vers le point de terminaison indiqué pour rester connecté en permanence.
  • Dès que l'état "VERIFIED" est reçu, fermez immédiatement la connexion et connectez l'utilisateur avec succès.

Alternatives d'écoute (Fallbacks) :

  • Plan B (Polling) : Si votre environnement d'hébergement ne prend pas en charge SSE, vous pouvez effectuer une requête traditionnelle GET vers /api/verify/status?id=... toutes les 3 secondes.
  • Plan C (Webhooks) : Vous pouvez compter sur les notifications automatiques de nos serveurs vers votre serveur. En savoir plus dans la section Webhooks.

États retournés (Session States) :

  • PENDING : Le client n'a pas encore envoyé le message. Continuez à écouter.
  • VERIFIED : Le message a été envoyé et le numéro a été vérifié avec succès.
  • EXPIRED : Expiration (après 2 minutes maximum).
Code d'intégration (SDK)
curl -N https://[your-domain.com]/api/verify/stream?id=YOUR_REQUEST_ID

Interactive API Playground | Testez les API | *En direct*

Expérimentez l'envoi de requêtes de vérification directement et générez des codes d'intégration dans le langage de programmation de votre choix.

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