跳到正文
OTPRun

验证码

在 WhatsApp 里发送验证码。秒级送达，自动校验。

OTPRun 生成验证码，用用户的语言通过 WhatsApp 发送；若 WhatsApp 未能及时确认送达，则回退到 Telegram，并校验用户输入的内容。验证码绝不以明文存储。

免费创建账号API 参考

免费套餐包含一个 WhatsApp 号码，无需绑定银行卡。

你将获得

  • 渠道自动回退

    如果 WhatsApp 在几秒内没有确认送达，同一个验证码会转到 Telegram。无论在哪里被读到，都是同一个验证码、同一次校验。

  • 点击即验证

    不发送验证码，而是给用户一个链接：用户点击后，从自己的 WhatsApp 把验证码发给你。无需发出消息，你的号码也没有风险。

  • 内置安全机制

    验证码哈希存储，限制错误尝试次数，设置有效期，并按手机号和 IP 地址限流，防范短信泵攻击和暴力破解。

一次请求

用手机号创建验证，显示验证码输入框，然后校验用户输入的内容。结果为通过、错误、已过期或已锁定。

发送并校验验证码
curl -X POST https://otprun.com/v1/verifications \
  -H "Authorization: Bearer $OTPRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"+77010000000","app_name":"Acme"}'

curl -X POST https://otprun.com/v1/verifications/$ID/check \
  -H "Authorization: Bearer $OTPRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"482913"}'

如何开始

  1. 免费创建账号并复制项目 API 密钥。

  2. 绑定一个 WhatsApp 号码，或使用 OTPRun 的 Telegram 机器人。

  3. 用户注册时调用 POST /v1/verifications，用户输入验证码时调用 POST /v1/verifications/{id}/check。

常见问题

相比短信为什么更便宜？

通过你绑定的 WhatsApp 号码和 Telegram 发送验证码都没有按条费用。你只需支付固定月费，而不是每条短信几分钱。

如果用户没有 WhatsApp 怎么办？

项目的路由策略会转到下一个渠道，默认是 Telegram。你也可以用 POST /v1/numbers/check 提前检查号码。

验证码支持哪些语言？

消息模板内置 24 种语言，你也可以自己编写文本，用占位符插入验证码、应用名称和有效期。

验证码有效多久？

默认五分钟。可设置为 30 秒到 15 分钟，验证码长度 4 到 8 位，并可设置尝试次数。

OTPRun 的更多用法

十分钟发出第一个验证码。一个密钥，一次调用，搞定。

创建工作区，绑定号码或使用 Telegram 机器人，然后在控制台发出第一次验证。

免费创建账户