API de verificação do MAX em massa por número de telefone

Verifique se os números de telefone do seu arquivo estão registrados no aplicativo de mensagens MAX (oneme.ru). Mesmo fluxo de tarefa em lote que outros verificadores de redes sociais/mensagens.

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"'

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`

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

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