ReOTP.
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)
curl -N https://[your-domain.com]/api/verify/stream?id=YOUR_REQUEST_ID

交互式 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"
  }'