iMessage批量号码检查器API：快速号码验证

检查输入的全球号码的iMessage详细信息，是否为iMessage账户

上传检测文件代码示例：

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

检查任务状态代码示例：

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,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "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...",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

上传文件请求URL

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

上传文件请求参数

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

检查任务状态请求URL

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

检查任务状态请求参数

参数	描述
task_id	string，任务创建时返回的任务ID

结果字段

字段	描述	示例
Number	E.164格式的电话号码	+12025551234
imessage	号码是否有活跃的iMessage账户	yes, no

响应格式

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

状态代码

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