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

检测输入的全球手机号是否已注册 CoinW 账户。

上传检测文件示例：

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

查询任务状态示例：

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

上传文件请求地址

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

上传文件请求参数

参数	说明
`file`	`file`, 上传文件，每行一个手机号（E.164 格式）
`task_type`	`string`, 任务类型，设置为 “coinW”

查询任务状态请求地址

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

查询任务状态请求参数

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

结果字段

字段	说明	示例
`Number`	E.164 格式的手机号	+12025551234
`coinw`	手机号是否拥有有效的 CoinW 账户	是、否

响应字段

字段	说明
`created_at`	任务创建时间
`updated_at`	任务状态最后更新时间
`task_id`	唯一任务标识
`user_id`	用户标识
`status`	任务状态： `pending`：已排队等待处理 `processing`：正在处理 `exported`：结果可供下载 `failed`：任务失败，已扣费用自动退回
`total`	已处理的手机号总数
`success`	成功识别的手机号数量
`failure`	处理失败的手机号数量
`result_url`	可选。状态为 `exported` 时的结果下载地址
`actual_amount`	（可选）实际扣费金额，任务结算后返回
`estimated_amount`	（创建响应）任务预估费用，最终以任务完成后的结算金额为准

状态码

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