WhatsApp 批量号码检测 Details API

检测全球手机号是否为已注册 WhatsApp 账号，并获取详细资料信息。

API 地址

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

主要功能

WhatsApp 批量号码检测 Details API 提供全面的验证能力：

账号信息

详细的 WhatsApp 账号信息，包括：

账号状态验证
用户个性签名
状态更新时间戳

批量处理

通过文件上传同时处理多个号码，适合大规模验证。

实时状态更新

通过实时状态更新监控批量验证任务进度。

使用步骤

文件上传

上传包含 E.164 格式电话号码的文本文件：

请求示例

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

请求参数

参数	类型	说明
`file`	`file`	待检测号码文件，每行一个号码
`task_type`	`string`	`ws_active` — 活跃度/签名等字段

状态查询

查询任务处理进度：

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",
  "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",
  "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",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

结果字段

字段	说明	示例
`Number`	E.164 格式电话号码	+41798284651
`signature`	WhatsApp 状态/个性签名	”Hey there! I am using WhatsApp”
`status_update`	最后状态更新时间	2025-01-19
`whatsapp`	是否有活跃 WhatsApp 账号	yes, no

API 响应体字段说明

字段	说明
`created_at`	任务创建时间戳
`updated_at`	任务状态最后更新时间
`task_id`	唯一任务标识
`status`	任务状态：pending / processing / completed / exported
`total`	处理的号码总数
`success`	成功识别的号码数
`failure`	处理失败的号码数
`result_url`	（可选）状态为 exported 时的结果下载地址

HTTP 状态码

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

集成注意事项

输入文件中每行应为一个 E.164 格式的电话号码。
使用返回的 task_id 轮询任务状态。
当状态为 exported 时，从 result_url 下载结果。
在应用中妥善处理不同状态码。

常见问题

1. API 的处理能力如何？

API 可高效处理大批量号码，并实时返回处理进度。

2. 输入文件应采用什么格式？

应为纯文本文件，每行一个 E.164 格式号码（例如 +41798284651）。

3. API 返回哪些信息？

API 返回详细账号信息，包括：

WhatsApp 账号状态
用户个性签名（例如「Hey there! I am using WhatsApp」）
最后状态更新时间戳

4. API 如何定价？

价格为每 1 万条号码 2 美元，包含状态更新与签名等详细 WhatsApp 账号信息。

更多定价及更大批量处理说明，请联系我们。