API de Verificação Detalhada em Massa do WhatsApp: Informações de Perfil e Status

Verifique os detalhes do WhatsApp do número global de entrada, se é uma conta WhatsApp, assinatura e atualização de status.

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

curl --location 'https://api.checknumber.ai/wa/api/detail/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"input.txt"'

Exemplo de código de verificação de status da tarefa:

curl --location 'https://api.checknumber.ai/wa/api/detail/tasks/cs9viu7i61pkfs4oavvg' \
--header 'X-API-Key: API-KEY'

Resposta para o upload bem-sucedido do arquivo de detecção

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Resposta para o status de processamento

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Resposta indicando que a tarefa foi concluída e incluindo a URL de download dos resultados

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

URL de solicitação de upload de arquivo

POST https://api.checknumber.ai/wa/api/detail/tasks

Parâmetros de solicitação de upload de arquivo

Parâmetro	Descrição
user_id	string, ID do usuário
file	file, Arquivo de upload, cada linha deve conter um número de telefone no formato E.164

URL de solicitação de detalhes da tarefa

GET https://api.checknumber.ai/wa/api/detail/tasks/{TASK_ID}

Parâmetros de solicitação de detalhes da tarefa

Parâmetro	Descrição
user_id	string, ID do usuário

Campos do Resultado

Campo	Descrição	Exemplo
Number	Número de telefone no formato E.164	+41798284651
signature	Assinatura do status do WhatsApp	”Hey there! I am using WhatsApp”
status_update	Hora da última atualização de status	2025-01-19
whatsapp	Se o número tem uma conta WhatsApp ativa	sim, não

Formato da Resposta

Campo	Descrição
created_at	Timestamp de criação da tarefa
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: Em processamento completed: Processamento concluído exported: Resultados disponíveis para download
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

Códigos de Status

Status	Descrição
200	charge, Solicitação bem-sucedida, tarefa criada ou status recuperado
400	free, Requisição inválida, parâmetros ou formato de arquivo inválidos
500	free, Erro interno do servidor, tente novamente mais tarde