API 接口/2. 检查验证状态
1 阅读需1分钟
2. 检查验证状态
查询当前验证会话的状态。
启动验证过程并获取 requestId 后,您的应用程序应实时监听(使用 SSE (Server-Sent Events))会话状态,以了解客户是否已成功发送消息。
方案 A:常规机制(SSE - 最快):
- 创建连接到指定端点的
EventSource以保持持续连接。
- 一旦获取状态
"VERIFIED",请立即断开连接并成功登录用户。
备用监听机制(Fallbacks):
- 方案 B(轮询 - Polling): 如果您的托管环境不支持 SSE,您可以通过每 3 秒向
/api/verify/status?id=...发送一次GET请求来进行传统轮询。
- 方案 C(Webhooks): 您可以依赖从我们服务器直接发送到您服务器的自动通知。详情请查阅 Webhooks 章节。
返回状态(Session States):
PENDING:客户尚未发送消息。请继续监听。
VERIFIED:已成功发送消息并完成号码验证。
EXPIRED:已过期(最长 2 分钟)。
集成代码(SDKs)
交互式 API 演练场
直接测试发送验证请求,并生成您偏好的编程语言集成代码。
curl -X POST https://reotp.com/api/verify/init \
-H "Authorization: Bearer 15a1c1c7-ed05-40df-b7c3-69c327542a07" \
-H "Content-Type: application/json" \
-d '{
"phoneNumber": "201000000000",
"method": "WHATSAPP"
}'