Flowstates messaging platform logo
    OTP API 与 SMS OTP 服务

    OTP API 的代码 实际到达。

    用于验证流程的专用 OTP API。多供应商 SMS 路由、亚秒级联、自动电子邮件回退和完整尝试跟踪 - 因此登录、注册和结帐在最后一步不会失败。对于一般消息传递,请参阅消息传递 API.

    快速解答

    OTP API 由两个接口组成:一个发送一次性验证码,另一个校验用户输入的验证码。Flowstates 的 OTP API 通过多家短信供应商发送,具备亚秒级故障切换与自动邮件兜底,即使某条线路劣化,验证码仍能送达,且每一次尝试都有记录可查。

    每个未发送的代码都是 丢失的用户

    OTP 交付是身份验证渠道的无声杀手。没有收到代码的用户不会重试 - 他们会离开。

    注册失败

    当OTP未到时,用户流失,购置成本浪费。

    转换泄漏

    即使是百分之几的 OTP 故障也会在登录、结帐和密码重置流程中复合。

    支持票

    每个未交付的代码都将成为一张票证 - 您的支持团队将成为供应商升级服务台。

    SMS 第一。 发邮件时SMS不会。

    一个 API 呼叫。多个 SMS 供应商按顺序尝试,以电子邮件作为安全网。用户通过任何可行的路径获取代码。

    // 1.发送OTP
    POST /v1/otp/send
    {
    "phone": "+44 7911 123456",
    "email": "user@example.com",
    "length": 6,
    "ttl_seconds": 300
    }
    // 2. 验证用户输入的内容
    POST /v1/otp/verify
    {
    "request_id": "otp_8f2a...",
    "code": "483921"
    }
    OTP API - 交付故障转移流程
    保证交付
    您的申请
    POST /v1/otp/send
    phone: "+44...", length: 6
    OTP 路由引擎
    SMS
    主要渠道
    Vendor A (Vonage)超时
    Vendor B (Sinch)被拒绝
    SMS 耗尽
    Email
    故障转移通道
    SendGridOTP 已交付
    OTP 已交付
    OTP 代码通过电子邮件发送
    SMS 供应商精疲力竭 - 自动电子邮件回退 - 代码在 1.2 秒内交付

    一个 API 呼叫。如果 SMS 在所有配置的供应商之间传送失败,OTP 会自动通过电子邮件发送 - 确保您的客户始终收到他们的代码。

    专为 验证,而非营销

    OTP API 在单独的路由路径上运行,具有自己的优先级通道、供应商堆栈和审计跟踪 - 专为短期、时间关键的代码而构建。

    多供应商 SMS 级联

    配置 SMS 供应商堆栈。如果供应商 A 失败或超时,则在任何后备通道启动之前会尝试供应商 B。

    SMS 至电子邮件后备

    如果每个 SMS 供应商都出现故障,则会通过电子邮件自动发送相同的代码,无需额外集成。

    优先路由

    OTP 绕过标准消息队列并通过最快的路径进行路由,与营销流量分开。

    亚秒级决策

    供应商选择、重试和回退决策在一秒钟内完成,因此用户无需等待。

    尝试跟踪

    每次发送、重试和验证尝试都会记录供应商、延迟和结果以供审核和分析。

    单端点

    发送一个 POST,验证一个 POST。无论使用 SMS、电子邮件还是后备,响应格式均一致。

    两个端点。 三步。

    01

    发送

    发布用户的电话和可选的电子邮件后备。我们生成、存储和发送代码。

    02

    级联

    我们按优先顺序尝试您配置的 SMS 供应商,然后在需要时退回到电子邮件 - 所有这些都在亚秒级时间内完成。

    03

    验证

    POST 用户输入的代码。我们确认、标记尝试并返回成功或键入的错误。

    OTP API 常见问题

    什么是 OTP API?

    OTP API 由两个接口组成:一个向用户发送一次性验证码,另一个校验用户输入的验证码。验证码生成、有效期、尝试次数限制与送达都由 API 负责,你的应用只需调用发送与校验。

    Flowstates 的 OTP API 与自行发送短信有何不同?

    普通短信发送只有一条线路,也不保存验证状态。OTP API 会在多家短信供应商之间亚秒级级联切换,短信送不到时自动改用邮件,并按请求记录每一次尝试,让失败可以被排查而不是猜测。

    验证码通过哪些渠道送达?

    以短信为主渠道,并自动使用邮件兜底。渠道顺序与各国供应商顺序会在上线准备阶段按你的流量配置。

    接入需要多久?

    两个 REST 调用:POST /v1/otp/send 返回 request_id,POST /v1/otp/verify 用它校验验证码。多数团队一天内即可接入,接口文档已公开。

    验证码长度和有效期可以自定义吗?

    可以。长度与有效期是请求参数;重发与尝试次数限制按账户设置,可与你的安全策略保持一致。

    某家短信供应商线路劣化时会怎样?

    级联会自动切到下一条已配置线路;若仍未确认送达,则触发邮件兜底。Flowstates 以 99.99% 的网关 SLA 运营网关,并代你排查线路层面的故障。

    停止流失用户 验证步骤。

    带上您自己的 SMS 和电子邮件供应商,或使用我们的。无论哪种方式,API 都保持不变。