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

API 功能

头像获取 通过 userHash 解析号码并获取其公开头像 URL

原图或预览 通过 type 参数选择原图或 96x96 预览缩略图

隐私感知 头像被隐私隐藏或未设置时返回明确的 hasAvatar 标志与错误码

在线 API 演示

GET /api/project/whatsapp/get-avatar

API 响应 (JSON)

{}

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

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

📢

需要帮助？

如遇接口异常，或需要其他接口需求，可联系我们

联系我们

使用场景

为 CRM 联系人补充 WhatsApp 头像
在客服/销售工具中于对话前展示头像
用返回的内容 hash 检测头像变化

WhatsApp：获取头像（资料照片）

API 功能

在线 API 演示

API 响应 (JSON)

使用场景

相关接口

相关指南