Flowstates messaging platform logo
    OTP API et service SMS OTP

    Une API OTP pour des codes qui arrivent vraiment.

    Une API OTP conçue pour les parcours de vérification. Routage SMS multi-fournisseurs, cascade en moins d'une seconde, basculement automatique vers l'e-mail et suivi complet des tentatives - pour que connexions, inscriptions et checkouts ne cassent pas à la dernière étape. 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.

    Chaque code non livré est un utilisateur perdu

    La livraison OTP est le tueur silencieux des tunnels d'authentification. Les utilisateurs qui ne reçoivent pas le code ne réessaient pas - ils partent.

    Inscriptions échouées

    Quand l'OTP n'arrive pas, l'utilisateur abandonne et le coût d'acquisition est perdu.

    Fuite de conversion

    Même quelques points de défaillance OTP se cumulent sur les parcours de connexion, checkout et réinitialisation de mot de passe.

    Tickets support

    Chaque code non livré devient un ticket - votre équipe support se transforme en bureau d'escalade fournisseur.

    SMS d'abord. E-mail quand le SMS ne passe pas.

    Un seul appel API. Plusieurs fournisseurs SMS sont essayés dans l'ordre, avec l'e-mail comme filet de sécurité. L'utilisateur reçoit le code via le chemin qui fonctionne.

    // 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.

    Conçue pour la vérification, pas le marketing

    L'API OTP utilise un chemin de routage séparé avec sa propre voie prioritaire, sa pile de fournisseurs et sa piste d'audit - pensée pour des codes à courte durée de vie et critiques dans le temps.

    Cascade SMS multi-fournisseurs

    Configurez une pile de fournisseurs SMS. Si le Fournisseur A échoue ou expire, le Fournisseur B est essayé avant tout canal de secours.

    Basculement SMS vers e-mail

    Si tous les fournisseurs SMS échouent, le même code est envoyé automatiquement par e-mail sans intégration supplémentaire.

    Routage prioritaire

    Les OTP contournent les files standards et passent par le chemin le plus rapide, séparés du trafic marketing.

    Décisions en moins d'une seconde

    Sélection fournisseur, retries et fallback se décident en moins d'une seconde pour que l'utilisateur ne reste pas bloqué.

    Suivi des tentatives

    Chaque envoi, retry et vérification est consigné avec fournisseur, latence et résultat pour audit et analytics.

    Endpoint unique

    Un POST pour envoyer, un POST pour vérifier. Format de réponse cohérent, qu'il s'agisse de SMS, d'e-mail ou de fallback.

    Deux endpoints. Trois étapes.

    01

    Envoyer

    POSTez le téléphone de l'utilisateur et éventuellement l'e-mail de secours. Nous générons, stockons et expédions le code.

    02

    Cascade

    Nous essayons vos fournisseurs SMS dans l'ordre de priorité puis nous basculons vers l'e-mail si nécessaire - le tout en moins d'une seconde.

    03

    Vérifier

    POSTez le code saisi par l'utilisateur. Nous confirmons, 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.

    Ne perdez plus d'utilisateurs à l'étape de vérification.

    Apportez vos fournisseurs SMS et e-mail ou utilisez les nôtres. L'API reste la même dans les deux cas.