API Verificador de Números em Massa do iMessage: Verificação Rápida de Números

Verifique os detalhes do iMessage do número global inserido, se é uma conta iMessage

Exemplo de código para upload do arquivo de detecção:

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

Exemplo de código para verificar 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 o upload bem-sucedido do arquivo de detecção

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Resposta para o status de processamento

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

Forneça uma resposta indicando que a tarefa está concluída e inclua a URL de download dos resultados.

{
    "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...",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

URL da requisição de upload de arquivo

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

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

Parâmetro	Descrição
file	file, Upload do arquivo, cada linha deve conter um número de telefone no formato E.164
task_type	string, Tipo de tarefa, definido como “imessage”

URL da requisição de verificação do status da tarefa

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

Parâmetros da requisição de verificação do status da tarefa

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

Campos de Resultado

Campo	Descrição	Exemplo
Number	Número de telefone no formato E.164	+12025551234
imessage	Se o número tem uma conta iMessage ativa	yes, no

Formato de Resposta

Campo	Descrição
created_at	Timestamp de quando a tarefa foi criada
updated_at	Timestamp da última atualização do status da tarefa
task_id	Identificador único da tarefa
user_id	ID do usuário
status	Status da tarefa: pending: Na fila e aguardando processing: Processando atualmente exported: Resultados disponíveis para download failed: A tarefa falhou, o valor cobrado é reembolsado automaticamente
total	Total de números de telefone processados
success	Números identificados com sucesso
failure	Números que falharam no processamento
result_url	(Opcional) URL de download dos resultados quando o status é exported
actual_amount	(Opcional) Valor efetivamente cobrado, disponível após a liquidação da tarefa
estimated_amount	(Resposta de criação) Valor estimado da tarefa; a cobrança final é liquidada na conclusão

Códigos de Status

Status	Descrição
200	free, Solicitação bem-sucedida (ex.: consulta de status)
202	charge, Tarefa criada com sucesso; o valor estimado é deduzido
400	free, Solicitação inválida: parâmetros ou formato de arquivo inválidos, tipo de tarefa não suportado ou entradas válidas abaixo do lote mínimo
401	free, Chave de API ausente ou inválida
402	free, Saldo insuficiente
404	free, Tarefa não encontrada
413	free, Arquivo enviado muito grande
500	free, Erro interno do servidor, tente novamente mais tarde