API del Verificador de Números Masivo de WhatsApp: Verificación Rápida de Números de Teléfono por Lotes

Verificar los detalles del WhatsApp del número global ingresado, si es una cuenta de WhatsApp. Servicio basado en detección en tiempo real por lotes.

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

curl --location 'https://api.ekycpro.com/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./number.txt"' \
--form 'task_type="ws"'

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

curl --location 'https://api.ekycpro.com/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

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/v1/tasks

Parámetros de solicitud para cargar archivo

Parámetro	Descripción
`file`	`file`, Archivo a cargar, cada línea debe contener un número de teléfono en formato E.164
`task_type`	`string`, Tipo de tarea, establecer en “ws”

URL de solicitud para verificar el estado de la tarea

POST https://api.ekycpro.com/v1/gettasks

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

Parámetro	Descripción
`task_id`	`string`, ID de tarea devuelto de la creación de tarea

Campos de Resultado

Campo	Descripción	Ejemplo
`Number`	Número de teléfono en formato E.164	+41798284651
`whatsapp`	Si el número tiene una cuenta activa de WhatsApp	yes (sí), no (no)

Formato de Respuesta

Campo	Descripción
`created_at`	Marca de tiempo de 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 `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 de resultados cuando el estado es `exported`

Códigos de Estado

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