WA Lookup

头像字段语义

应如何理解 avatar 与 avatar_url？

一次完成的 ws_avatar 检测会返回注册状态，并报告当时是否可获得账号头像；只有服务能够返回地址时才会包含 avatar_url。应将这些字段用于时点性的资料补充，而不是用来证明账号活跃、可信或由特定人员控制。

先读取 registered

WhatsApp 注册状态以 registered 为准。avatar=false 不会改变注册结果，也不能解释为号码未注册。

头像可用性会变化

资料可见性和账号设置可能变化。请保存检测时间；当当前头像状态会影响决策时，应重新检测。

不能将头像作为身份证明

可用头像补充记录，但它不能验证账号所有者、图片中的人物，也不代表获得了图片使用许可。

正确使用结果

让一次单号码检测真正有用的三个细节

提交一个手机号

请包含国家区号，例如 +14155552671，确保每次请求对应一个明确的号码。

读取所选产品字段

当前 service_type 只返回其定义的 WhatsApp 字段；需要不同字段时请选择对应产品。

使用同步返回结果

后端会同步返回所选字段；需要更新状态时请重新检测，联系用户前仍需取得相应同意。

API 契约

一次请求，立即返回

查看完整 API 文档

提交一个手机号，并用 service_type 选择本产品；认证使用你的 API Key。

请求POST /api/v1/check
{
  "service_type": "ws_avatar",
  "identifier": "+14155552671"
}
响应200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_avatar",
    "identifier": "+14155552671",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://pps.waavatar.xyz/v/example.jpg"
  }
}

产品常见问题

关于头像检测的常见问题

WhatsApp 头像检测 检测什么？

它对一个手机号进行检测，并在同一次同步响应中返回注册状态、是否设置头像，以及在可获取时返回头像地址。

头像检测如何计费？

仅在检测完成后扣除余额；上游失败或无判定的请求不会保留扣费。

需要提交什么？

请提交你的工作流要检测的手机号。

显示已注册，是否代表获得了联系许可？

不是。结果仅反映检测时可获得的 WhatsApp 状态字段；同意、接收方偏好和适用的平台规则仍需由您自行遵守。

相关产品

按需选择检测产品

wsWhatsApp 注册检测通过同步 API 或网页后台确认手机号是否已注册 WhatsApp，适合发送前检查联系人名单。ws_businessWhatsApp 商业账号检测在确认 WhatsApp 注册状态的同时识别商业账号标记，帮助区分商业联系人。