Skip to content

手机号验证 API

验证用户是否拥有其提供的手机号。

数秒内确认号码归属

手机号验证是所有可信用户体验的基础。通过短信、WhatsApp 或语音电话发送一次性密码(OTP),数秒内确认号码归属。

什么是手机号验证?

手机号验证是证明眼前的人确实控制着他们所输入手机号的过程。表单里的号码只是一个声明,验证则把它变成证据。没有验证,注册字段就会接受拼写错误、一次性号码、他人的号码,以及脚本随意粘贴进来的任何内容。

这份证据有三个各自独立的价值。其一,它给您一个有效的联系渠道,让密码重置和投递通知能到达真实的手机。其二,它为账号提供稳定的标识符,让多账号和奖励滥用变得昂贵。其三,它为您提供日后可以依靠的第二重因素,而无需用户再登记任何新内容。

手机号验证如何运作

所有手机号验证流程都基于同一个理念:手机上必须发生只有持有者才能促成的事情。经典做法是通过短信发送一次性验证码,并要求用户输回。Phone-Verif 反其道而行之:由用户发送消息,而不是接收消息;但整体结构相同:创建会话、给出挑战、等待证明、读取结果。

实际上,这意味着您这一侧有三个组成部分。一个开启验证会话并给您可展示给用户内容的调用;一个供用户操作的界面或组件;以及获知结果的方式,可以通过 callback,也可以读取会话状态。

WhatsApp 验证

WhatsApp 是这里的主要渠道。API 返回一个包含简短会话令牌的 WhatsApp 深度链接,您可在桌面端将其渲染为二维码,在移动端渲染为按钮。用户点击后,WhatsApp 会打开并带有预先写好的消息,他们只需发送。WhatsApp 会向服务器报告发送方号码,由于该号码在账号创建时已由 WhatsApp 验证过,您便继承了一份无需自行构建的证明。

这能覆盖多少流量,完全取决于市场。WhatsApp 在巴西、印度以及欧洲和非洲大部分地区的使用几乎是全民性的,而在美国、日本和韩国则微不足道。在决定需要多少备用渠道之前,值得先看看您的用户究竟在哪里。

短信验证与备用方案

对于没有 WhatsApp 的用户,同一个会话也接受通过短信发送的同一个令牌:用户改为把令牌作为普通文本消息发送到验证号码。会话、令牌以及您之后读取的状态都完全一致,因此您的集成无需分支,只有展示给用户的指引会变化。

这比听起来更重要。仅支持 WhatsApp 的流程会悄悄流失低普及率市场的所有用户;仅支持短信的流程则要为每次尝试向运营商付费,包括机器人触发的那些。把两者放在同一个会话中,您就能默认使用便宜又安全的渠道,同时仍能触达其余用户。

Reverse OTP:方向为何重要

在传统的 OTP 流程中,服务器发送一个秘密,并寄希望于它只送达正确的手机、不会落入别处。SIM 卡劫持攻击和 OTP 钓鱼都利用了这一假设,人为虚增流量之所以有利可图也是因为它:无论背后是否有真实用户,每次尝试都要花您一条消息的钱。

Reverse OTP 去掉了这一假设。不向用户发送任何秘密,因此没有可拦截的内容,没有可从用户那里钓走的东西,也没有欺诈者可向您计费的出站消息。用户自己的发送行为就是证明。

端到端的验证流程

会话从 pending(待处理)状态开始。当用户看到预填消息时进入 whatsapp_previewed,打开链接时进入 opened,消息到达并与会话匹配后变为 verified。如果无人在规定时间内操作,则以 expired 结束。

只有 verified 状态才携带手机号,在此之前该字段为 null。请把状态视为信号、号码视为其载荷,切勿颠倒,这一条规则就能消除人们初次集成时遇到的大多数竞态条件。

集成 API

集成只需两个 REST 调用。POST /start-verification 开启会话,返回 WhatsApp 号码、深度链接,以及一个托管的网页 URL(如果您希望重定向而非自建界面)。GET /check-verification-status 返回会话状态,验证通过后还会返回号码本身。

您也可以完全跳过界面,把托管的验证页面嵌入 iframe,这是最快跑通的方式。无论哪种方式,在生产环境中都应优先使用 callback 而非轮询,仅在开发阶段或用户明确返回您的页面时才进行轮询。

安全与隐私

会话生命周期很短,每个令牌只绑定唯一一个会话,因此被重放的消息不会匹配到任何会话。您收到的号码来自 WhatsApp 自身的基础设施,而非用户输入,这就堵住了用户随便输入别人的号码、再等待自己拦截到验证码的漏洞。

在隐私方面,该流程转移的个人数据比它所取代的流程更少:没有验证码经由电信网络送达用户,您存储的是已验证的号码,而不是一连串投递尝试的记录。

价格

验证按预付积分计费。没有订阅,积分也不会过期,因此季节性的注册高峰该花多少就花多少,清淡的月份则分文不花。新账号自带免费积分,足以在预发布环境中完整跑通流程,再决定是否投入。

常见问题

什么是手机号验证 API?
手机号验证 API 是一种 HTTP 接口,用于证明用户控制着某个手机号。您调用它来开启验证会话,向用户展示其返回的内容,并在用户操作完成后读取已验证的号码。
没有 WhatsApp 也能进行手机号验证吗?
可以。同一个会话也接受通过短信发送的验证令牌,没有 WhatsApp 的用户改为以普通文本消息发送令牌。无论哪种方式,您的集成都从同一个端点读取结果。
一次验证需要多长时间?
API 调用本身是即时的,其余时间用于用户扫码并点击发送。实际上,大多数会话在数秒内完成,而不是数分钟,因为没有需要等待的运营商投递环节。
号码验证通过后 API 会返回什么?
会话状态变为 verified,响应中包含经过验证的手机号,以及所经过各步骤的时间戳。在此之前,号码字段为 null。
手机号验证与双因素认证是一回事吗?
不是。手机号验证证明号码属于该用户,通常在注册时进行一次。双因素认证则在登录或敏感操作前重新检查这一证明。同一套 API 可以同时覆盖两者,但它们回答的是不同的问题。

Related

常见场景

联系方式验证

确认用户提供的是真实、可触达的手机号。

客户引导注册

从第一天起就以经过验证的联系方式建立信任。

号码校验

拒绝无效、一次性或无法触达的号码。

用户身份确认

将手机号与用户资料绑定,实现安全的身份核验。

Build your 手机号验证 flow today

Start integrating in minutes with clear documentation, SDKs, and global message delivery.