WhatsApp 号码校验与资料查询 APIs

WhatsApp 校验 API:检测号码是否在 WhatsApp 上,并获取头像、About 状态、在线状态与企业资料。两步式实时验证与公开资料查询。JSON API,适用于线索校验、联系人增强、CRM 与消息可达性。仅使用公开数据。

🔍

存在性检测(按完整号码)

对单个号码进行轻量存在性检测——仅返回该号码是否注册了 WhatsApp,不拉取资料/头像/企业详情,比完整资料查询更便宜。当 isExist=true 时,响应还会包含 userHash,需将其传给资料类接口(获取头像/About/企业资料/在线状态)以授权更重的查询。后端会自动从完整号码中拆分国家码,并回显 countryCode 供你核对。

GET /api/project/whatsapp/check-exist-by-phone
📦

存在性检测(国家码 + 号码分开)

与「存在性检测」相同,但国家码与国内号码分别作为参数传入。当你已知国家码、希望跳过后端自动拆分时使用。当 isExist=true 时,响应同样包含可传给资料类接口的 userHash。

GET /api/project/whatsapp/check-exist-by-cc-phone

获取头像(资料照片)

获取 WhatsApp 用户的公开头像(DP)。两步流程:先调用存在性检测接口获取目标号码的 userHash,再将其传到此处。无有效(或已过期/未知)userHash 的调用会被拒绝。号码由 userHash 在服务端解析,不接受号码参数。若用户无头像或因隐私隐藏,则 hasAvatar=false。可用 type 选择原图或小尺寸预览缩略图。

GET /api/project/whatsapp/get-avatar
🔄

获取 About / 状态文本

获取用户的 About(状态签名)文本及其设置时间。两步流程:先通过存在性检测接口获取 userHash,再传到此处。无效/过期 userHash 会被拒绝。未设置 / 隐私(仅联系人)/ 未注册时返回 about=null。

GET /api/project/whatsapp/get-about
📡

获取企业资料

获取 WhatsApp 企业资料:企业名称、认证等级、简介、地址、邮箱、网站及加入时间等。两步流程:先通过存在性检测接口获取 userHash,再传到此处。无效/过期 userHash 会被拒绝。个人(非企业)号码返回 isBusiness=false。

GET /api/project/whatsapp/get-biz-profile
🔗

获取在线 / 最后在线状态

获取在线状态 / 最后在线时间。受目标隐私强约束:若请求方非其联系人,且目标的最后在线/在线隐私未设为「所有人」,则不会下发在线状态,visible=false(真实结果,无法绕过)。两步流程:先通过存在性检测接口获取 userHash,再传到此处。单次调用最长可能耗时约 17 秒。

GET /api/project/whatsapp/get-presence
📋

检测活跃状态

实时检测号码是否在 WhatsApp 上注册并活跃。对完整国际号码直接返回活跃标志——独立检测,无需 userHash。适用于注册流程与列表清洗中的快速是/否校验。

GET /api/project/whatsapp/check-active
🌐

批量检测(最多 10 个)

在单次请求中检测最多 10 个号码是否注册了 WhatsApp,逐个返回 exist 与 isBusiness 状态。以逗号分隔传入号码列表。适合一次校验小批量号码。

GET /api/project/whatsapp/batch-check-10