API de perfil completo do MAX: gênero, última visualização e avatar

Para números de telefone registrados no aplicativo de mensagens MAX (oneme.ru), recupere suas informações completas de perfil: ID da conta, nome de exibição, gênero, hora da última visualização e link do avatar.

Exemplo para enviar o arquivo de detecção:

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

Exemplo para consultar o status da tarefa:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Resposta para upload bem-sucedido

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2026-05-18T11:00:00.000000000Z"
}

Resposta para status de processamento

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

Resposta quando a tarefa for concluída (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 da requisição para upload de arquivo

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

Parâmetros da requisição para upload de arquivo

Parâmetro	Descrição
file	file, um número de telefone por linha (formato E.164, por exemplo +79991234567)
task_type	string, defina como max_full

Tamanho mínimo de lote: 1000 números por tarefa.

URL da requisição para consultar status

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

Parâmetros da requisição para consultar status

Parâmetro	Descrição
task_id	string, ID da tarefa retornado na criação

Campos do resultado

Campo	Descrição	Exemplo
Number	Número de telefone em formato E.164	+79991234567
max	Se o número está registrado no aplicativo de mensagens MAX	yes, no
id	ID de usuário interno da conta MAX (apenas quando max=yes)	75240310
name	Nome de exibição da conta (primeiro / sobrenome, pode estar parcialmente vazio)	Екатерина Сагайдак
gender	Gênero da conta (quando preenchido pelo usuário)	male, female
last_seen	Status de atividade / descrição da última visualização	last seen recently, last seen 2 days ago
avatar	URL da imagem do avatar (vazio quando o usuário não tem avatar)	https://i.oneme.ru/i?r=…

Linhas com max=no têm todas as colunas de perfil vazias.

Formato da resposta

Campo	Descrição
created_at	Timestamp quando a tarefa foi criada
updated_at	Timestamp da última atualização de status da tarefa
task_id	Identificador único da tarefa
user_id	ID do usuário
status	pending · processing · exported
total	Total de números de telefone processados
success	Números identificados com sucesso
failure	Números que falharam no processamento
result_url	URL de download quando status é exported

Códigos de status

Status	Descrição
200	charge, solicitação bem-sucedida
400	free, requisição inválida
500	free, erro do servidor