Telegram Days Checker API: Check Last Online Time

Check the days since last online for Telegram accounts of the input global phone numbers

上传检测文件示例：

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

查询任务状态示例：

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

上传文件请求参数

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

查询任务状态请求地址

POST https://api.ekycpro.com/v1/gettasks

查询任务状态请求参数

参数	说明
task_id	string, 创建任务返回的 Task ID

结果字段

字段	说明	示例
Number	Phone number in E.164 format	+12025551234
telegram_days	Days since last online for Telegram account	1, 7, 30, N/A

响应字段

Field	Description
created_at	Timestamp when task was created
updated_at	Timestamp of last task status update
task_id	Unique task identifier
user_id	ID of user
status	Task status: pending: Queued and waiting processing: Currently processing exported: Results available for download
total	Total phone numbers processed
success	Numbers successfully identified
failure	Numbers that failed processing
result_url	(Optional) Download URL for results when status is exported

状态码

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