API de Verificador de Avatar de Números Masivo de WhatsApp (Edad y Género): Análisis de Perfil y Demografía

Verificar la información del avatar de WhatsApp del número global de entrada, si es una cuenta de WhatsApp, la URL de la foto de perfil, género, edad, color de cabello, color de piel, así como el tipo de foto de perfil.

Ejemplo de código para subir archivo de detección:

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

Ejemplo de código para verificar estado de tarea:

curl --location 'https://api.checknumber.ai/wa/api/avatar/tasks/cs9viu7i61pkfs4oavvg?user_id=USER_ID' \
--header 'X-API-Key: API-KEY'

Respuesta para la subida exitosa del archivo de detección

{
  "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
}

Respuesta para el estado de procesamiento

{
  "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
}

Proporciona una respuesta indicando que la tarea está completada e incluye la URL de descarga para los 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 solicitud para subir archivo

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

Parámetros de solicitud para subir archivo

Parámetro	Descripción
user_id	string, ID de usuario
file	file, Archivo de subida, cada línea debe contener un número de teléfono en formato E.164

URL de solicitud para verificar estado de tarea

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

Parámetros de solicitud para verificar estado de tarea

Parámetro	Descripción
user_id	string, ID de usuario

Campos de Resultado

Campo	Descripción	Ejemplo
Number	Número de teléfono en formato E.164	+41798284651
age	Rango de edad estimado basado en la foto de perfil	25
avatar	URL de la foto de perfil de WhatsApp	https://example.com/avatar.jpg
category	Clasificación de tipo de foto de perfil	retrato individual, avatar de mascota, objeto, etc.
gender	Género detectado de la foto de perfil	masculino, femenino
hair_color	Color de cabello detectado de la foto de perfil	negro, marrón, rubio, etc.
skin_color	Etnia/raza detectada de la foto de perfil	blanco, negro, etc.
whatsapp	Si el número tiene cuenta activa de WhatsApp	yes, no

Formato de Respuesta

Campo	Descripción
created_at	Marca de tiempo cuando se creó la tarea
updated_at	Marca de tiempo de la última actualización del estado de la tarea
task_id	Identificador único de la tarea
user_id	ID del usuario
status	Estado de la tarea: pending: En cola y esperando processing: Procesando actualmente completed: Procesamiento terminado exported: Resultados disponibles para descarga
total	Total de números de teléfono procesados
success	Números identificados exitosamente
failure	Números que fallaron en el procesamiento
result_url	(Opcional) URL de descarga para resultados cuando el estado es exported

Códigos de Estado

Estado	Descripción
200	charge, Solicitud exitosa, tarea creada o estado recuperado
400	free, Solicitud incorrecta, parámetros inválidos o formato de archivo
500	free, Error interno del servidor, reintentar más tarde