API de Verificação Profunda em Massa do WhatsApp: Análise de Perfil e Demografia

Verifique as informações profundas do WhatsApp do número global de entrada, se é uma conta WhatsApp, a URL da foto do perfil, gênero, idade, cor do cabelo, cor da pele, bem como o tipo de foto do perfil.

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

curl --location 'https://api.ekycpro.com/wa/api/deep/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'user_id="USER_ID"' \
--form 'file=@"input.txt"'

Exemplo de código para verificar o status da tarefa:

curl --location 'https://api.ekycpro.com/wa/api/deep/tasks/cs9viu7i61pkfs4oavvg?user_id=USER_ID' \
--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 para upload de arquivo

POST https://api.ekycpro.com/wa/api/deep/tasks

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

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

URL de solicitação para verificar status da tarefa

GET https://api.ekycpro.com/wa/api/deep/tasks/{TASK_ID}

Parâmetros de solicitação para verificar status 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
age	Faixa etária estimada com base na foto do perfil	25
avatar	URL da foto de perfil do WhatsApp	https://example.com/avatar.jpg
category	Classificação do tipo de foto do perfil	retrato individual, avatar de animal de estimação, objeto, etc.
gender	Gênero detectado na foto do perfil	masculino, feminino
hair_color	Cor do cabelo detectada na foto do perfil	preto, castanho, loiro, etc.
skin_color	Etnia/raça detectada na foto do perfil	branco, negro, etc.
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