Flowstates messaging platform logo
    API OTP - vérification SMS avec basculement fournisseur

    Une API OTP qui prévoit le fournisseur qui flanche.

    Chaque fournisseur SMS a ses mauvaises heures : un opérateur rejette un Sender ID, une route se dégrade, les accusés de réception se taisent. Notre API OTP envoie le code via une liste ordonnée de fournisseurs SMS, passe au suivant quand une tentative échoue ou expire, et peut se replier sur l'e-mail - derrière deux endpoints REST. Pour la messagerie générale, voir l'API de messagerie.

    Réponse rapide

    Une API OTP est une paire d'endpoints qui envoie un code à usage unique et vérifie le code saisi par l'utilisateur. L'API OTP de Flowstates envoie via plusieurs fournisseurs SMS, avec bascule en moins d'une seconde et repli automatique par e-mail : les codes arrivent même quand une route se dégrade, et chaque tentative est journalisée.

    Pourquoi les codes OTP se perdent

    La plupart des échecs OTP ne sont pas des pannes. Ils sont partiels : un pays, un opérateur, un type d'expéditeur. Une intégration mono-fournisseur n'a nulle part où envoyer la tentative suivante.

    Dégradation de route

    La route accepte toujours les messages mais livre en retard, ou pas du tout. L'API répond succès, l'utilisateur ne voit jamais le code.

    Filtrage expéditeur et opérateur

    Les opérateurs réécrivent ou bloquent les Sender ID et filtrent le contenu. Ce qui passe dans un pays est rejeté dans le suivant.

    Accusés peu fiables

    Les accusés de réception peuvent être tardifs, absents ou faux : attendre un accusé est un mauvais signal de basculement. L'étape de vérification est le signal fiable.

    Basculement ordonné. E-mail quand le SMS ne passe pas.

    Un seul appel d'envoi. Vous fixez l'ordre des fournisseurs ; quand une tentative échoue, nous passons au suivant. Si toutes les tentatives SMS échouent, le même code peut partir par e-mail.

    // 1. Envoyer l'OTP
    POST /v1/otp/send
    {
    "phone": "+44 7911 123456",
    "email": "user@example.com",
    "length": 6,
    "ttl_seconds": 300
    }
    // 2. Vérifier ce que l'utilisateur a saisi
    POST /v1/otp/verify
    {
    "request_id": "otp_8f2a...",
    "code": "483921"
    }
    API OTP - Flux de basculement de livraison
    Livraison garantie
    Votre application
    POST /v1/otp/send
    phone: "+44...", length: 6
    Moteur de routage OTP
    SMS
    Canal principal
    Vendor A (Vonage)délai dépassé
    Vendor B (Sinch)rejeté
    SMS épuisé
    Email
    Canal de secours
    SendGridOTP livré
    OTP livré
    Code OTP livré par e-mail
    Fournisseurs SMS épuisés - basculement automatique vers l'e-mail - code livré en 1,2 s

    Un seul appel API. Si la livraison SMS échoue chez tous les fournisseurs configurés, l'OTP est envoyé automatiquement par e-mail afin que votre client reçoive toujours son code.

    Réponses aux questions de basculement des développeurs

    Le trafic OTP suit son propre chemin de routage, séparé des envois marketing, avec sa propre liste de fournisseurs et sa piste d'audit.

    Quand le basculement se déclenche-t-il ?

    Quand un fournisseur rejette le message, renvoie une erreur ou ne répond pas à temps. Les accusés de réception seuls ne valent preuve ni dans un sens ni dans l'autre.

    Quels fournisseurs ?

    Utilisez nos routes, vos propres comptes fournisseurs, ou les deux. Les appels API restent identiques.

    Et si toutes les routes SMS échouent ?

    Si vous avez transmis une adresse e-mail, le code part par e-mail sans intégration supplémentaire.

    Séparé du marketing

    Les OTP ne font pas la queue derrière les campagnes et utilisent leur propre configuration d'expéditeur et de fournisseurs.

    Que puis-je auditer ?

    Chaque envoi, nouvel essai et vérification est journalisé avec le fournisseur utilisé, l'horodatage et le résultat.

    Le parcours de vérification SMS : deux endpoints, trois étapes.

    01

    Envoyer

    POSTez le numéro de l'utilisateur et un e-mail de repli facultatif. Nous générons, stockons et expédions le code.

    02

    Basculer

    Nous essayons vos fournisseurs SMS dans l'ordre défini, passons au suivant quand une tentative échoue, puis nous replions sur l'e-mail si besoin.

    03

    Vérifier

    POSTez le code saisi. Nous le contrôlons, enregistrons la tentative et renvoyons un succès ou une erreur typée.

    FAQ API OTP

    Qu'est-ce qu'une API OTP ?

    Une API OTP est une paire d'endpoints : l'un envoie un code à usage unique à l'utilisateur, l'autre vérifie le code saisi. L'API gère la génération du code, l'expiration, les limites de tentatives et la livraison ; votre application n'appelle que envoyer et vérifier.

    En quoi l'API OTP de Flowstates diffère-t-elle d'un envoi SMS classique ?

    Un envoi SMS simple n'a qu'une route et aucun état de vérification. L'API OTP bascule entre plusieurs fournisseurs SMS en moins d'une seconde, se replie sur l'e-mail quand le SMS n'arrive pas et journalise chaque tentative par requête, ce qui permet de diagnostiquer au lieu de deviner.

    Par quels canaux les codes sont-ils livrés ?

    Le SMS en canal principal, avec repli automatique par e-mail. L'ordre des canaux et l'ordre des fournisseurs par pays sont configurés pour votre trafic lors de l'onboarding.

    Combien de temps prend l'intégration ?

    Deux appels REST : POST /v1/otp/send renvoie un request_id, POST /v1/otp/verify vérifie le code. La plupart des équipes intègrent en une journée ; la référence est publiée dans notre documentation.

    Puis-je contrôler la longueur et l'expiration du code ?

    Oui. La longueur et la durée de vie sont des paramètres de requête, et les limites de renvoi et de tentatives sont définies par compte pour correspondre à votre politique de sécurité.

    Que se passe-t-il si un fournisseur SMS se dégrade ?

    La cascade passe automatiquement à la route suivante et le repli e-mail se déclenche si le code n'est toujours pas confirmé comme livré. Flowstates exploite la passerelle avec un SLA de 99,99 % et analyse les défaillances de route pour vous.

    Testez votre basculement OTP sur votre trafic réel.

    Nous passons en revue vos routes OTP, pays et points de défaillance actuels avant que vous ne changiez quoi que ce soit.