Facebook 邮箱检测 API：快速验证邮箱

检测输入的邮箱地址是否已注册 Facebook。

上传检测文件示例：

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

查询任务状态示例：

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

上传检测文件成功响应：

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

处理中状态响应：

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

任务完成响应（包含结果下载 URL）：

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

上传文件请求地址

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

上传文件请求参数

参数	说明
file	file, 上传文件，每行一个邮箱地址
task_type	string, 任务类型，设置为 “facebook_email”

查询任务状态请求地址

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

查询任务状态请求参数

参数	说明
task_id	string，创建任务返回的任务标识

结果字段

字段	说明	示例
Email	邮箱地址	user@example.com
facebook	邮箱是否已注册 Facebook	是、否

响应字段

字段	说明
created_at	任务创建时间
updated_at	任务状态最后更新时间
task_id	唯一任务标识
user_id	用户标识
status	任务状态： pending：已排队等待处理 processing：正在处理 exported：结果可供下载
total	已处理的邮箱地址总数
success	成功验证的邮箱地址数量
failure	处理失败的邮箱地址数量
result_url	可选。状态为 exported 时的结果下载地址

状态码

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