Saltearse al contenido

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

Verificar la información del avatar del WhatsApp del número global ingresado, 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 cargar archivo de detección:

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

Ejemplo de código para verificar el estado de la tarea:

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

Respuesta para la carga 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
}

Proporcione una respuesta indicando que la tarea está completada e incluya la URL de descarga de 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 cargar archivo

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

Parámetros de solicitud para cargar archivo

ParámetroDescripción
user_idstring, ID de usuario
filefile, Archivo a cargar, cada línea debe contener un número de teléfono en formato E.164

URL de solicitud para verificar el estado de la tarea

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

Parámetros de solicitud para verificar el estado de la tarea

ParámetroDescripción
user_idstring, ID de usuario

Campos de Resultado

CampoDescripciónEjemplo
NumberNúmero de teléfono en formato E.164+41798284651
ageRango de edad estimado basado en la foto de perfil25
avatarURL de la foto de perfil de WhatsApphttps://example.com/avatar.jpg
categoryClasificación del tipo de foto de perfilretrato individual, avatar de mascota, objeto, etc.
genderGénero detectado en la foto de perfilmale (masculino), female (femenino)
hair_colorColor de cabello detectado en la foto de perfilblack (negro), brown (marrón), blonde (rubio), etc.
skin_colorEtnia/raza detectada en la foto de perfilwhite (blanco), black (negro), etc.
whatsappSi el número tiene una cuenta activa de WhatsAppyes (sí), no (no)

Formato de Respuesta

CampoDescripción
created_atMarca de tiempo de cuando se creó la tarea
updated_atMarca de tiempo de la última actualización del estado de la tarea
task_idIdentificador único de la tarea
user_idID del usuario
statusEstado de la tarea:
pending: En cola y esperando
processing: Procesando actualmente
completed: Procesamiento finalizado
exported: Resultados disponibles para descarga
totalTotal de números de teléfono procesados
successNúmeros identificados exitosamente
failureNúmeros que fallaron en el procesamiento
result_url(Opcional) URL de descarga de resultados cuando el estado es exported

Códigos de Estado

EstadoDescripción
200cobro, Solicitud exitosa, tarea creada o estado recuperado
400gratis, Solicitud incorrecta, parámetros o formato de archivo inválido
500gratis, Error interno del servidor, inténtelo de nuevo más tarde