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

Verifique os detalhes do WhatsApp do número global de entrada, se é uma conta do WhatsApp. Serviço baseado em detecção em tempo real em lote.

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

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

Exemplo de código para verificar status da tarefa:

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

Resposta para o carregamento 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
}

Forneça uma resposta indicando que a tarefa foi concluída e inclua 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 para carregar arquivo

POST https://api.ekycpro.com/v1/tasks

Parâmetros de solicitação para carregar arquivo

Parâmetro	Descrição
`file`	`file`, Arquivo para upload, cada linha deve conter um número de telefone no formato E.164
`task_type`	`string`, Tipo de tarefa, definir como “ws”

URL de solicitação para verificar status da tarefa

POST https://api.ekycpro.com/v1/gettasks

Parâmetros de solicitação para verificar 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	+41798284651
`whatsapp`	Se o número tem conta ativa do WhatsApp	yes (sim), no (não)

Formato de Resposta

Campo	Descrição
`created_at`	Timestamp de 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`	Status da tarefa: `pending`: Na fila e aguardando `processing`: Processando atualmente `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`, Solicitação inválida, parâmetros ou formato de arquivo inválido
`500`	`free`, Erro interno do servidor, tente novamente mais tarde