跳转到内容

Kucoin批量号码检查器API:快速电话号码验证

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

上传检测文件代码示例:

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

检查任务状态代码示例:

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

上传文件请求URL

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

上传文件请求参数

参数描述
filefile,上传文件,每行应包含一个E.164格式的电话号码
task_typestring,任务类型,设置为”Kucoin”

检查任务状态请求URL

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

检查任务状态请求参数

参数描述
task_idstring,任务创建时返回的任务ID

结果字段

字段描述示例
NumberE.164格式的电话号码+12025551234
kucoin号码是否有活跃的Kucoin账户yes, no

响应格式

字段描述
created_at任务创建时的时间戳
updated_at上次任务状态更新的时间戳
task_id唯一任务标识符
user_id用户ID
status任务状态:
pending:已排队等待
processing:当前正在处理
exported:结果可供下载
total处理的电话号码总数
success成功识别的号码
failure处理失败的号码
result_url(可选)当状态为exported时的结果下载URL

状态代码

状态描述
200charge,请求成功,任务已创建或状态已检索
400free,错误请求,无效参数或文件格式
500free,内部服务器错误,请稍后重试