WhatsApp批量头像、年龄和性别检测API：个人资料分析

检查输入的国际手机号的 WhatsApp 头像信息，包括是否是 WhatsApp 账号、头像 URL、性别、年龄、发色、肤色以及头像类型。

上传检测文件代码示例：

curl --location 'https://api.numberchecker.ai/wa/api/deep/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"input.txt"'

检查任务状态代码示例：

curl --location 'https://api.numberchecker.ai/wa/api/deep/tasks/cs9viu7i61pkfs4oavvg' \
--header 'X-API-Key: API-KEY'

上传检测文件成功的响应

{
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 20000,
  "estimated_amount": {
    "amount": "2.000000",
    "currency": "USD"
  },
  "message": "Task created successfully. Numbers are being validated and processed in the background.",
  "created_at": "2024-10-19T18:24:56.450567423Z"
}

处理状态的响应

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

任务完成时的响应，包含结果下载链接

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

上传文件请求网址

POST https://api.numberchecker.ai/wa/api/deep/tasks

上传文件请求参数

参数	说明
user_id	string, 用户 ID
file	file，上传文件，每行应包含一个E.164格式的电话号码

检查任务状态请求网址

GET https://api.numberchecker.ai/wa/api/deep/tasks/{TASK_ID}

检查任务状态请求参数

参数	说明
user_id	string, 用户 ID

结果字段

字段	说明	示例
Number	E.164 格式的手机号	+41798284651
age	基于头像估计的年龄范围	25
avatar	WhatsApp 头像 URL	https://example.com/avatar.jpg
category	头像类型分类	个人肖像、宠物头像、物品等
gender	从头像检测的性别	男性、女性
hair_color	从头像检测的发色	黑色、棕色、金色等
skin_color	从头像检测的种族/肤色	白色、黑色等
whatsapp	该号码是否开通 WhatsApp 账号	yes, no

响应格式

字段	说明
created_at	任务创建时间戳
updated_at	任务状态最后更新时间戳
task_id	唯一任务标识符
user_id	用户 ID
status	任务状态： pending: 已排队等待 processing: 正在处理 completed: 处理完成 exported: 结果可下载 failed：任务失败，已扣费用自动退回
total	已处理的总手机号数量
success	成功识别的号码数量
failure	处理失败的号码数量
result_url	（可选）当状态为exported时的结果下载链接
actual_amount	（可选）实际扣费金额，任务结算后返回
estimated_amount	（创建响应）任务预估费用，最终以任务完成后的结算金额为准

状态码

状态码	说明
200	free，请求成功（如状态查询）
202	charge，任务创建成功，预扣预估费用
400	free，错误的请求：参数或文件格式无效、任务类型不支持、或有效数据量低于最小批量
401	free，API Key 缺失或无效
402	free，账户余额不足
404	free，任务不存在
413	free，上传文件过大
500	free，内部服务器错误，请稍后重试