注册并联系客服，免费领取 100 次检测。免费注册
AvatarLookup
AvatarLookup 工作流示意图：单次与批量头像解析：根据数据源进行选择
本文所述工作流的示意图（AvatarLookup）。

了解如何根据数据源选择单次或批量头像解析，从直接图片上传到消息平台的异步批量处理。

选择单次还是批量头像解析，取决于您的工作流是从视觉资产开始，还是从原始标识符开始。AvatarLookup 将解析过程分为三个清晰的层级。当已有图片资产时，图片人像解析可对文件进行直接视觉分析。当您仅持有标识符时，WhatsApp 和受支持的邮箱域名提供实时单次查询或同步多标识符查询。对于 Telegram、Viber、LINE、Zalo 和 MAX 上的大规模数据，异步批量任务通过分阶段的 CSV 导出处理标识符列表。了解这种基于数据源的划分，可确保团队为每个数据管道集成合适的请求模式。

用于现有视觉资产的图片人像解析

当团队已拥有图形文件或托管的视觉资产时，图片人像解析是首选的评估层级。此工作流不使用电话号码或账号查询外部通信网络，而是直接评估图片本身。提交过程依赖于多部分文件上传，支持 JPEG、PNG、WebP 或 GIF 等常见 Web 图片格式。

系统从提交的文件中提取算法内容指纹，而非将其链接至个人账号标识符。生成的有效载荷提供结构化的人像属性，包括图片类别分类，以及针对年龄、性别、肤色和发色的算法估计。团队可利用此方法在账号注册时筛选用户上传的头像、审计历史照片库或对入站创意媒体进行分类。由于该分析独立于外部平台存在，因此可按需处理单个媒体文件。

针对 WhatsApp 和邮箱的实时标识符查询

当您仅持有标识符而非图片资产时，实时查询会检查受支持服务上的公共头像是否可访问。此功能专门适用于 WhatsApp 电话号码以及受支持的 Web 邮箱域名，涵盖 Gmail、Yandex 和 Mail.ru 地址。

团队可使用 POST /api/v1/check 进行单条记录的同步查询，或使用 POST /api/v1/batch-check 进行分组标识符查询。多项查询端点可在单个请求中处理 1 到 100 个标识符，并返回一个有序的 JSON 数组。对于邮箱资料，查询结果会显示该地址是否可接收邮件，以及任何公共人像属性。在同步响应中，exists 属性作为执行指标，true 表示已生成结果，false 则表示输入无效或结果未确定。此模式支持实时潜在客户路由、注册筛选和响应式联系人丰富工作流。

针对消息网络异步批量任务

跨更广泛社交生态系统的大规模数据处理，已从实时调用转向异步文件处理。Telegram、Viber、MAX、LINE 和 Zalo 的资料服务仅通过批量任务运行。大规模的 WhatsApp 和邮箱集合也可通过批量处理进行排队，以在无需维护持续套接字连接的情况下处理长列表。

批量工作流要求使用纯 TXT 或 CSV 文件，且每行仅包含一个标识符。不支持 XLSX 等电子表格格式。电话号码文件必须包含标准化的数字（无空格或前导符号），并随附 ISO 3166-1 国家代码提交。Telegram 用户名任务接受带有或不带前缀符号的用户名，无需区域国家参数。由于各产品存在文件限制和最低标识符阈值，团队在准备输入集前应查阅最新的平台 API 文档。

端到端批量生命周期与 CSV 结果提取

异步批量任务的操作遵循为后台作业队列设计的三个阶段集成模式：

  • 任务创建： 客户端系统使用 POST /api/v1/bulk-tasks 提交格式化文件。对于电话服务，国家代码需在多部分传输中置于文件有效载荷之前。平台将返回一个唯一的任务 ID。
  • 状态轮询： 客户端通过调用 GET /api/v1/bulk-tasks/{id} 监控作业进度。自动轮询周期不应超过每 30 秒一次，以防止不必要的网关开销。
  • CSV 提取： 任务成功完成后，状态端点将提供一个有效期为 12 小时的安全 CSV 下载链接。如果数据管道出现提取延迟，刷新任务查询可延长过期链接的有效期。

输出架构反映了底层产品系列。邮箱批次返回标识符、activated 状态和头像图片路径，而 Telegram 文件返回平台标识符、活跃天数和视觉属性估计。管道工程师必须根据其记录的列规范解析每个产品文件。

常见问题解答

哪些消息平台支持实时单次查询？

实时单次查询和同步多项查询仅适用于 WhatsApp 和受支持的邮箱域名，具体为 Gmail、Yandex 和 Mail.ru 地址。其他消息平台（包括 Telegram、Viber、LINE、Zalo 和 MAX）仅作为异步批量文件工作流运行，不支持即时同步查询。

电话号码批量任务有哪些文件要求？

批量任务要求使用格式化的 TXT 或 CSV 文件，每行包含一个标识符，且不得包含电子表格格式。对于电话列表，号码需为国家代码格式的数字，并去除加号或标点符号。团队在多部分提交中需在文件前提供 ISO 3166-1 国家参数，具体的文件限制请参阅官方 API 文档。

团队应如何解读空头像或 exists=false 的响应？

在同步多项查询中，exists=false 表示标识符无效、查询未确定或端点未触达，而非账号不存在的最终证明。同样，空的头像 URL 或非人类类别反映的是算法上未确定的视觉字段，而非资料验证或身份确认。

了解更多

选择符合您工作流下一步的产品信息。

参考来源