Pular para o conteúdo

API do Verificador de Avatar em Massa do WhatsApp (Idade e Gênero): Análise de Perfil e Demografia

Verifique as informações do avatar do WhatsApp do número global de entrada, se é uma conta do 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 carregar arquivo de detecção:

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

Exemplo de código para verificar status da tarefa:

curl --location 'https://api.ekycpro.com/wa/api/deep/tasks/cs9viu7i61pkfs4oavvg' \
--header 'X-API-Key: API-KEY'

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/wa/api/deep/tasks

Parâmetros de solicitação para carregar arquivo

ParâmetroDescrição
user_idstring, ID do usuário
filefile, 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âmetroDescrição
user_idstring, ID do usuário

Campos de Resultado

CampoDescriçãoExemplo
NumberNúmero de telefone no formato E.164+41798284651
ageFaixa etária estimada com base na foto do perfil25
avatarURL da foto do perfil do WhatsApphttps://example.com/avatar.jpg
categoryClassificação do tipo de foto do perfilretrato individual, avatar de animal de estimação, objeto, etc.
genderGênero detectado na foto do perfilmale (masculino), female (feminino)
hair_colorCor do cabelo detectada na foto do perfilblack (preto), brown (castanho), blonde (loiro), etc.
skin_colorEtnia/raça detectada na foto do perfilwhite (branco), black (preto), etc.
whatsappSe o número tem conta ativa do WhatsAppyes (sim), no (não)

Formato de Resposta

CampoDescrição
created_atTimestamp de quando a tarefa foi criada
updated_atTimestamp da última atualização de status da tarefa
task_idIdentificador único da tarefa
user_idID do usuário
statusStatus da tarefa:
pending: Na fila e aguardando
processing: Processando atualmente
completed: Processamento concluído
exported: Resultados disponíveis para download
totalTotal de números de telefone processados
successNúmeros identificados com sucesso
failureNúmeros que falharam no processamento
result_url(Opcional) URL de download dos resultados quando o status é exported

Códigos de Status

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