service_type： ws_avatar

WhatsApp 头像检测

在确认注册状态的同时，判断账号是否设置了可见头像。

免费注册查看 API 契约

使用成本2 积分 / 次

响应方式同步

API 接口POST /api/v1/check

检测内容

WhatsApp 头像检测会返回什么？

在注册结果之外补充头像可用性，帮助评估账号完整度，并为依赖头像信号的流程提供依据。

适用场景

在以下场景使用本产品

资料补全
账号审查
客服流程
联系人可信度信号

API 契约

一次请求，立即返回

查看完整 API 文档

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

请求POST /api/v1/check

{
  "service_type": "ws_avatar",
  "identifier": "+14155552671"
}

响应200 OK

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": 123,
    "identifier": "+14155552671",
    "registered": true,
    "transaction_id": "chk_example123",
    "status": "success",
    "service_type": "ws_avatar",
    "avatar": true,
    "avatar_url": "https://pps.waavatar.xyz/v/example.jpg",
    "charged_credits": 2
  }
}

返回字段

本产品新增的字段

registeredboolean

号码是否已注册 WhatsApp。

avatarboolean

是否存在可用头像。

avatar_urlstring?

上游返回头像时提供的头像地址。

注册状态请始终以 registered为准；产品特有字段为 false 并不代表号码未注册。

产品常见问题

关于头像检测的常见问题

WhatsApp 头像检测检测什么？

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

头像检测的费用是多少？

每次完成的检测消耗 2 积分；上游失败或无判定的请求不会保留扣费。

需要什么手机号格式？

请使用带国家码的 E.164 格式，例如 +14155552671。

响应会暴露缓存状态吗？

不会。缓存处理是内部实现，客户端不应依赖 cached 字段。