结果指南
如何解读 WhatsApp 验证结果
WA Lookup 将已完成的注册判断与输入错误、限流、余额不足和临时服务失败分开。正确的集成应先理解响应状态，再读取注册、头像和商业账号字段。
审核日期：2026 年 7 月 21 日
registered 代表什么？
registered=true 表示一次已完成检测报告该 E.164 号码在请求时已注册 WhatsApp；registered=false 表示已完成检测报告当时未注册。失败或无判定请求没有 true/false 结论，应进入纠错或重试，不能直接写成 false。
读取产品字段前先判断响应 envelope
HTTP 状态和业务码说明请求是否产生可用结果；只有确定成功后才应消费 data 字段。
| 响应 | 分类 | 建议保存方式 |
|---|---|---|
| 成功 + registered=true | 已完成且已注册 | true + 检测时间 |
| 成功 + registered=false | 已完成且未注册 | false + 检测时间 |
| 400 | 产品、请求体或号码无效 | 输入错误，修正后重试 |
| 402 | 余额不足 | 计费阻断，不存在号码结论 |
| 429 | 限速或并发上限 | 可重试控制状态 |
| 503 或无判定 | 临时服务结果 | 待处理/重试，绝不能写 false |
附加字段应独立解读
头像与商业账号字段回答更窄的问题，其缺失或 false 不得覆盖注册状态。
- avatar=true 表示本次检测报告头像可用；avatar=false 不代表号码未注册。
- 没有可获取 URL 时 avatar_url 可以为空，应按可选字段处理。
- business=false 不证明账号属于个人、已失效或与企业无关。
- 保存字段时同时保存产品代码，明确本次实际请求了哪些信息。
为下游设计稳定的三态模型
将已注册、未注册、待处理分开，可避免临时故障污染联系人数据。技术处理状态也应与最近一次有效业务结果分离。
- 1
已完成且已注册
保存 true、检测时间和 service_type。
- 2
已完成且未注册
保存 false 与相同审计字段，不与输入错误合并。
- 3
待处理或可重试
用于 429、503、超时和无判定；在重试前保留已有有效状态。
- 4
输入被拒绝
将 400 类错误返回规范化或数据修正流程。
响应无法支持的结论
服务只检查所选账号状态字段，不提供身份、行为或同意证据。
- 不能识别号码由哪个个人或组织控制。
- 不会返回在线状态、最近在线、消息、群组或联系人。
- 不能保证消息送达或未来仍保持注册。
- 不能授予联系许可，也不能替代同意记录。