API de Verificação de Avatar, Idade e Gênero em Massa do WhatsApp: Análise de Perfil

Verifique as informações do avatar 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 do arquivo de detecção de upload:

curl --location 'https://api.numberchecker.ai/wa/api/deep/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.numberchecker.ai/wa/api/deep/tasks/cs9viu7i61pkfs4oavvg' \
--header 'X-API-Key: API-KEY'

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

{
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 20000,
  "estimated_amount": {
    "amount": "2.000000",
    "currency": "USD"
  },
  "message": "Task created successfully. Numbers are being validated and processed in the background.",
  "created_at": "2024-10-19T18:24:56.450567423Z"
}

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

URL de solicitação de upload de arquivo

POST https://api.numberchecker.ai/wa/api/deep/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 verificação de status da tarefa

GET https://api.numberchecker.ai/wa/api/deep/tasks/{TASK_ID}

Parâmetros de solicitação de verificação de 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 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