MAX 完整资料检测 API：性别、最后上线时间、头像

对已注册 MAX 即时通讯（oneme.ru）的手机号，获取完整账户资料：账户 ID、昵称、性别、最后上线时间及头像链接。

上传检测文件示例：

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

查询任务状态示例：

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": "2026-05-18T11:00:00.000000000Z"
}

处理中

{
    "created_at": "2026-05-18T11:00:00.000Z",
    "updated_at": "2026-05-18T11:01:30.000Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

完成（exported）

{
    "created_at": "2026-05-18T11:00:00.000Z",
    "updated_at": "2026-05-18T11:03:00.000Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip"
}

上传文件地址

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

上传参数

参数名	说明
file	file，每行一个号码（E.164 格式，如 +79991234567）
task_type	string，固定为 max_full

每批最少 1000 个号码。

查询任务状态地址

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

查询参数

参数名	说明
task_id	任务 ID

结果字段

字段名	说明	示例
Number	E.164 格式手机号	+79991234567
max	是否注册 MAX 即时通讯	yes, no
id	MAX 账户内部用户 ID（仅 max=yes 时有值）	75240310
name	账户昵称（名/姓，可能部分为空）	Екатерина Сагайдак
gender	账户性别（用户填写时有值）	male, female
last_seen	活跃状态 / 最后上线描述	last seen recently, last seen 2 days ago
avatar	头像图片 URL（无头像时为空）	https://i.oneme.ru/i?r=…

max=no 的行，所有资料列均为空。

响应字段说明

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

状态码

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