Telegram 活跃检测 API：查询最后在线时间

检测输入的全球号码 Telegram 账户的最后在线天数

上传检测文件示例：

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

查询任务状态示例：

curl --location 'https://api.numberchecker.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.numberchecker.ai/v1/tasks

上传参数

参数	说明
file	file，每行一个手机号（E.164 格式）
task_type	string，固定为 tg_active

查询任务状态地址

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

查询参数

参数	说明
task_id	任务 ID

结果字段

字段	说明	示例
Number	E.164 格式手机号	+12025551234
telegram_days	Telegram 账户最后在线天数	1, 7, 30, N/A

响应字段说明

字段	说明
created_at	创建时间
updated_at	最后更新时间
task_id	任务 ID
user_id	用户 ID
status	pending · processing · exported
total	总行数
success	成功数
failure	失败数
result_url	结果下载地址

状态码

状态	说明
200	charge，成功
400	free，请求无效
500	free，服务错误