WhatsApp 号码校验 API - 账号、资料、头像与企业信息查询

概览

💡

基础 URL https://api.opendata-api.com

每次调用都需要 API Key。在下方粘贴一次，之后每个请求都会自动附带。

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

存在性检测（按完整号码）

说明

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

Parameter	In	Value
`phoneNumber`*	query

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/check-exist-by-phone?key=<API_KEY>&phoneNumber=<phoneNumber>'

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

存在性检测（国家码 + 号码分开）

说明

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

Parameter	In	Value
`cc`*	query
`phone`*	query

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/check-exist-by-cc-phone?key=<API_KEY>&cc=<cc>&phone=<phone>'

GET /api/project/whatsapp/get-device-name

获取设备 / 机主名称

说明

获取 WhatsApp 账号的设备 / 机主显示名称（通常仅当前活跃账号有值）。两步流程：先调用存在性检测接口；仅当其响应的 hasExtra 列出 "deviceName" 时再调用本接口。将返回的 userHash 传到此处——号码由服务端解析。无效 / 过期 userHash 会被拒绝。字段缺失时 deviceName=null 且 message 说明原因。

Parameter	In	Value
`userHash`*	query

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/get-device-name?key=<API_KEY>&userHash=<userHash>'

GET /api/project/whatsapp/get-email

获取掩码备用邮箱

说明

获取 WhatsApp 账号的掩码备用邮箱（如 u*******6@gmail.com）。注意：这不是企业资料里的联系邮箱。两步流程：先调用存在性检测接口；仅当其响应的 hasExtra 列出 "email" 时再调用本接口。将返回的 userHash 传到此处——号码由服务端解析。无效 / 过期 userHash 会被拒绝。字段缺失时 email=null 且 message 说明原因。

Parameter	In	Value
`userHash`*	query

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/get-email?key=<API_KEY>&userHash=<userHash>'

GET /api/project/whatsapp/get-wa-old-device-name

获取历史设备名称

说明

获取 WhatsApp 账号的历史（上一个）设备名称。两步流程：先调用存在性检测接口；仅当其响应的 hasExtra 列出 "waOldDeviceName" 时再调用本接口。将返回的 userHash 传到此处——号码由服务端解析。无效 / 过期 userHash 会被拒绝。字段缺失时 waOldDeviceName=null 且 message 说明原因。

Parameter	In	Value
`userHash`*	query

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/get-wa-old-device-name?key=<API_KEY>&userHash=<userHash>'

GET /api/project/whatsapp/get-avatar

获取头像（资料照片）

说明

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

Parameter	In	Value
`userHash`*	query

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/get-avatar?key=<API_KEY>&userHash=<userHash>'

GET /api/project/whatsapp/get-about

获取 About / 状态文本

说明

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

Parameter	In	Value
`userHash`*	query

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/get-about?key=<API_KEY>&userHash=<userHash>'

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

获取企业资料

说明

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

Parameter	In	Value
`userHash`*	query

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/get-biz-profile?key=<API_KEY>&userHash=<userHash>'

GET /api/project/whatsapp/get-presence

获取在线 / 最后在线状态

说明

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

Parameter	In	Value
`userHash`*	query

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/get-presence?key=<API_KEY>&userHash=<userHash>'

GET /api/project/whatsapp/check-active

检测活跃状态

说明

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

Parameter	In	Value
`phoneNumber`*	path

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/check-active?key=<API_KEY>&phoneNumber=<phoneNumber>'

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

批量检测（最多 10 个）

说明

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

Parameter	In	Value
`accounts`*	query

curl -X GET 'https://api.opendata-api.com/api/project/whatsapp/batch-check-10?key=<API_KEY>&accounts=<accounts>'

WhatsApp 号码校验与资料查询 APIs

概览