OTP via l'API

Objectif

Vérifier un numéro de téléphone sans exposer le code côté client après l'envoi.

Envoi

POST /api/v1/otp/send
X-API-Key: rfl_live_…
Content-Type: application/json

Champ	Rôle
`brandName`	(optionnel) Nom affiché — ex. marque de votre app. Sinon : nom de votre organisation ReachFlow.
`template`	(optionnel) Texte avec `{{brand}}` et `{{code}}`. Défaut : `Votre code de vérification {{brand}} : {{code}}`

Exemple :

{
  "providerId": "…",
  "phoneNumber": "+33668460834",
  "brandName": "ReachFlow"
}

→ WhatsApp : Votre code de vérification ReachFlow : 482910

Le code est transmis uniquement par WhatsApp ; l'API ne renvoie jamais le code en clair (seulement otpId, messageId, expiresAt).

Paramètres complets : Référence OTP.

POST /api/v1/otp/verify
X-API-Key: rfl_live_…
Content-Type: application/json

{ "otpId": "uuid", "code": "123456" }

Réponse { "valid": true } ou { "valid": false, "reason": "…" } — 3 tentatives max.