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

Verificar los detalles de WhatsApp del número global de entrada, si es una cuenta de WhatsApp

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

curl --location 'https://api.checknumber.ai/wa/api/simple/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/simple/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/simple/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/simple/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
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