API полной проверки профиля MAX: пол, последнее посещение, аватар

Для номеров телефонов, зарегистрированных на мессенджере MAX (oneme.ru), получите полную информацию профиля: ID аккаунта, отображаемое имя, пол, время последнего посещения и ссылку на аватар.

Загрузка файла для проверки — пример:

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

Проверка статуса задачи — пример:

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

URL запроса загрузки файла

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

Параметры запроса загрузки файла

Параметр	Описание
`file`	`file`, один номер телефона на строку (формат E.164, например `+79991234567`)
`task_type`	`string`, установите `max_full`

Минимальный размер пакета: 1000 номеров на задачу.

URL запроса проверки статуса

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

Параметры запроса проверки статуса

Параметр	Описание
`task_id`	`string`, ID задачи, возвращаемый при создании

Поля результата

Поле	Описание	Пример
`Number`	Номер телефона в формате E.164	+79991234567
`max`	Зарегистрирован ли номер на мессенджере MAX	yes, no
`id`	Внутренний ID пользователя аккаунта MAX (только когда `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`	Уникальный идентификатор задачи
`user_id`	ID пользователя
`status`	`pending` · `processing` · `exported`
`total`	Всего обработано номеров телефонов
`success`	Номера успешно идентифицированы
`failure`	Номера с ошибкой обработки
`result_url`	URL для скачивания при статусе `exported`

Коды статуса

Статус	Описание
`200`	`charge`, запрос успешен
`400`	`free`, неправильный запрос
`500`	`free`, ошибка сервера