WhatsApp 批量号码检测 Simple API

WhatsApp 是全球主流的即时通讯平台，大规模验证账号状态可为企业带来重要洞察。本文介绍 WhatsApp 批量号码检测 Simple API，可高效同时验证多个号码的 WhatsApp 账号状态。

主要功能

WhatsApp 批量号码检测 Simple API 提供核心验证能力：

账号验证

快速、可靠地验证全球任意手机号的 WhatsApp 账号状态。

批量处理

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

实时状态更新

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

使用步骤

文件上传

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

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

获取任务详情

查询任务状态请使用 POST https://api.checknumber.ai/v1/gettasks，在表单中提交 task_id（见上文 curl）。请勿使用旧的 /wa/api/simple/... 路径。

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

请求参数

file：包含待检测号码的文件。
task_type：填写 ws 表示 WhatsApp 是否注册检测。参阅官方文档。

响应参数

task_id：任务 ID。
created_at：任务创建时间。
updated_at：任务最后更新时间。
status：任务状态。
total：任务中的号码总数。
success：成功检测的号码数。
failure：失败的号码数。
result_url：结果文件下载地址。

请求体

参数	类型	说明
`file`	`file`	待检测号码文件，每行一个号码
`task_type`	`string`	`ws` — WhatsApp 是否注册检测

响应体

参数	类型	说明
`task_id`	`string`	已创建任务的 ID
`created_at`	`string`	任务创建时间
`updated_at`	`string`	任务最后更新时间
`status`	`string`	任务状态，例如 pending、processing、completed、exported
`total`	`integer`	任务中的号码总数
`success`	`integer`	成功处理的号码数
`failure`	`integer`	失败的号码数
`result_url`	`string`	结果文件下载地址

结果字段

API 返回的基础验证信息包括：

电话号码（E.164 格式）
WhatsApp 账号状态（yes / no）

API 响应格式

API 提供详细的任务状态信息：

created_at：任务创建时间戳
updated_at：状态最后更新时间戳
task_id：唯一任务标识
status：当前任务状态（pending / processing / completed / exported）
total：处理的号码总数
success：成功处理的号码数
failure：处理失败次数
result_url：完成后的结果下载 URL

请求参数（补充说明）

文件上传时：

参数	说明
`file`	`file`，上传文件，每行一个 E.164 格式电话号码
`task_type`	固定为 `ws`（基础「是否注册 WhatsApp」检测）。

状态查询时：

参数	说明
`task_id`	创建任务时返回的 `task_id`

常见问题

1. API 的处理能力如何？

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

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

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

3. API 返回哪些信息？

API 返回基础验证信息：手机号是否有活跃的 WhatsApp 账号。

4. API 响应状态码有哪些？

200：请求成功（计费）
400：参数或文件格式无效（不计费）
500：服务器内部错误（不计费）

5. API 如何定价？

基础 WhatsApp 账号状态验证为每 1 万条号码 1 美元。

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