WhatsApp批量号码检测API：快速手机号验证

检查输入的国际手机号的WhatsApp详情，是否为WhatsApp账号。基于短期缓存和实时检测的服务。

上传检测文件代码示例：

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./number.txt"' \
--form 'task_type="ws"'

检查任务状态代码示例：

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

上传检测文件成功的响应

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

处理状态的响应

{
  "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"
}

上传文件请求网址

POST https://api.checknumber.ai/v1/tasks

上传文件请求参数

参数	说明
file	file，上传文件，每行应包含一个E.164格式的电话号码
task_type	string，任务类型，设置为”ws”

检查任务状态请求网址

POST https://api.checknumber.ai/v1/gettasks

检查任务状态请求参数

参数	说明
task_id	string，从任务创建返回的任务ID

结果字段

字段	说明	示例
Number	E.164格式的手机号	+41798284651
whatsapp	该号码是否有活跃的WhatsApp账号	yes, no

响应格式

字段	说明
created_at	任务创建时间戳
updated_at	任务状态最后更新时间戳
task_id	唯一任务标识符
user_id	用户ID
status	任务状态： pending: 已排队等待 processing: 正在处理 exported: 结果可下载
total	已处理的总手机号数量
success	成功识别的号码数量
failure	处理失败的号码数量
result_url	（可选）当状态为exported时的结果下载链接

状态码

状态码	说明
200	charge，请求成功，任务已创建或状态已获取
400	free，请求错误，参数或文件格式无效
500	free，服务器内部错误，请稍后重试