Una API OTP preparada para el proveedor que falla.
Todo proveedor de SMS tiene malas horas: un operador rechaza un remitente, una ruta se degrada, los recibos de entrega dejan de llegar. Nuestra API OTP envía el código a través de una lista ordenada de proveedores SMS, pasa al siguiente cuando un intento falla o agota su tiempo y puede recurrir al email, con dos endpoints REST. Para mensajería general, consulte la API de mensajería.
Respuesta rápida
Una API de OTP es un par de endpoints que envía un código de un solo uso y verifica el código que introduce el usuario. La API de OTP de Flowstates envía a través de varios proveedores de SMS con failover en menos de un segundo y respaldo automático por email, así los códigos llegan aunque una ruta se degrade, y cada intento queda registrado.
Por qué se pierden los códigos OTP
La mayoría de los fallos de OTP no son caídas totales. Son parciales: un país, un operador, un tipo de remitente. Una integración con un solo proveedor no tiene adónde enviar el siguiente intento.
Degradación de rutas
La ruta sigue aceptando mensajes pero entrega tarde o no entrega. La API responde con éxito y el usuario nunca ve el código.
Filtrado de remitentes y operadores
Los operadores reescriben o bloquean remitentes y filtran contenido. Lo que funciona en un país se rechaza en el siguiente.
Recibos poco fiables
Los recibos de entrega pueden llegar tarde, faltar o ser erróneos, así que no bastan como señal de failover. El paso de verificación es la señal fiable.
Failover ordenado. Email cuando el SMS no llega.
Una sola llamada de envío. Usted define el orden de proveedores; si un intento falla, pasamos al siguiente. Si todos los intentos SMS fallan, el mismo código puede enviarse por email.
Una sola llamada a la API. Si la entrega por SMS falla en todos los proveedores configurados, el OTP se envía automáticamente por email, para que tu cliente siempre reciba su código.
Respuestas a las preguntas de failover de los desarrolladores
El tráfico OTP usa su propia ruta, separada de los envíos de marketing, con su propia lista de proveedores y registro de auditoría.
¿Cuándo se activa el failover?
Cuando un proveedor rechaza el mensaje, devuelve un error o no responde a tiempo. Los recibos de entrega por sí solos no se toman como prueba.
¿Qué proveedores?
Use nuestras rutas, traiga sus propias cuentas de proveedor o combine ambas. Las llamadas a la API no cambian.
¿Y si fallan todas las rutas SMS?
Si incluyó un email, el código se envía por email sin integración adicional.
Separado del marketing
Los OTP no esperan detrás del tráfico de campañas y usan su propia configuración de remitente y proveedores.
¿Qué puedo auditar?
Cada envío, reintento y verificación queda registrado con el proveedor usado, los tiempos y el resultado.
El flujo de verificación por SMS: dos endpoints, tres pasos.
Enviar
Haga POST con el teléfono del usuario y un email de respaldo opcional. Generamos, guardamos y enviamos el código.
Failover
Probamos sus proveedores SMS en el orden definido, pasando al siguiente si un intento falla, y recurrimos al email si es necesario.
Verificar
Haga POST con el código introducido. Lo comprobamos, registramos el intento y devolvemos éxito o un error tipado.
Preguntas frecuentes sobre la API de OTP
¿Qué es una API de OTP?
Una API de OTP es un par de endpoints: uno envía un código de un solo uso al usuario y otro verifica el código que introduce. La API gestiona la generación del código, la caducidad, los límites de intentos y la entrega, así tu aplicación solo llama a enviar y verificar.
¿En qué se diferencia la API de OTP de Flowstates de enviar un SMS por tu cuenta?
Un envío de SMS simple tiene una sola ruta y no guarda el estado de verificación. La API de OTP escala entre varios proveedores de SMS con failover en menos de un segundo, recurre al email cuando el SMS no llega y registra cada intento por solicitud para diagnosticar en lugar de suponer.
¿Por qué canales se entregan los códigos?
SMS como canal principal, con respaldo automático por email. El orden de canales y el orden de proveedores por país se configuran para tu tráfico durante el onboarding.
¿Cuánto tarda la integración?
Dos llamadas REST: POST /v1/otp/send devuelve un request_id y POST /v1/otp/verify comprueba el código contra él. La mayoría de equipos integra en un día; la referencia está publicada en nuestra documentación.
¿Puedo controlar la longitud y la caducidad del código?
Sí. La longitud y el tiempo de vida son parámetros de la solicitud, y los límites de reenvío e intentos se definen por cuenta para ajustarse a tu política de seguridad.
¿Qué ocurre si un proveedor de SMS se degrada?
La cascada pasa automáticamente a la siguiente ruta configurada y el respaldo por email se activa si el código sigue sin confirmarse como entregado. Flowstates opera el gateway con un SLA del 99,99% e investiga los fallos de ruta por ti.
Pruebe el failover con su tráfico real.
Revisaremos sus rutas OTP, países y puntos de fallo actuales antes de que cambie nada.