验证方法
WA Lookup 如何验证 WhatsApp 号码
WA Lookup 接收一个 E.164 手机号，根据所选 service_type 同步返回 WhatsApp 检测结果。本页说明请求如何执行、不同状态代表什么、何时扣费或退款，以及结果不能被过度解读的边界。
审核日期：2026 年 7 月 21 日
一次 WhatsApp 检测会经历什么？
系统先校验并规范请求，预留所选产品的检测费用，再对一个号码发起同步检测，并在同一个 HTTP 响应中返回结果。检测得到可用结果后完成扣费；失败、超时或无判定时退回预留余额，且不能把这类请求归类为已注册或未注册。
从输入号码到获得结果的完整流程
网页后台与 REST API 共用相同的验证服务，因此人工检测与程序调用的响应含义、扣费和限流规则一致。
- 1
规范化号码
提交一个带国家区号的 E.164 手机号。无效号码或冲突字段会在验证前被拒绝。
- 2
选择所需产品
ws 查询注册状态，ws_avatar 增加头像可用性，ws_business 增加商业账号字段。
- 3
预留余额并同步检测
系统在调用验证服务前预留所选产品费用；限流或并发拒绝不会形成已完成结果。
- 4
确认扣费或退回余额
可用结果会保存到日志并完成扣费；失败或无判定会退回余额，最终扣费记为零。
业务结果与 HTTP 成功不是同一概念
必须结合响应 envelope 与 data 字段判断结果。网络错误或服务异常不能作为号码状态的证据。
| 状态 | 含义 | 建议动作 |
|---|---|---|
| 完成 · registered=true | 本次检测报告该号码在请求时已注册 WhatsApp。 | 保存检测时间与 service_type。 |
| 完成 · registered=false | 本次检测报告该号码在请求时未注册。 | 与输入无效、临时失败分开保存。 |
| 无判定或服务错误 | 没有产生可用的注册判断。 | 保持待处理或稍后重试，不能写成 false。 |
| 429 | 达到用户限速或并发上限。 | 退避并将多余任务排队。 |
| 503 | 验证服务暂时不可用。 | 稍后重试，并保留已有的最近一次有效状态。 |
三款产品分别增加什么信息
选择能够回答当前问题的最小产品即可；返回更多字段并不会让注册结果更具身份权威性。
- ws 只回答注册状态，适合作为名单清洗的默认产品。
- ws_avatar 增加头像可用性及可获取时的头像 URL；没有头像不代表未注册。
- ws_business 增加商业账号标记；false 不代表账号虚假、无效或不属于企业。
- 所有字段均描述检测时点的状态，之后可能发生变化。
运营与同意边界
验证结果是数据质量信号，不是身份或联系许可证明。应同时保存结果、检测时间、产品代码和处理状态，让下游能够区分已完成判断与可重试失败。
- 不得据此推断姓名、身份、号码所有权、活跃度、最近在线或消息内容。
- 已注册不代表已取得联系该号码的同意。
- 业务需要当前状态时应重新检测，不能默认旧结果永久有效。
- 应按自身访问和留存政策保护手机号、API Key 与导出的检测日志。