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

Verifique los detalles de WhatsApp del número global ingresado, si es una cuenta de WhatsApp. Servicio basado en caché a corto plazo y detección en tiempo real.

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

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

Ejemplo de código para verificar estado de tarea:

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

Respuesta indicando que la tarea está completada e incluye la URL de descarga de 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.checknumber.ai/v1/tasks

Parámetros de solicitud para cargar archivo

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

URL de solicitud para verificar estado de tarea

POST https://api.checknumber.ai/v1/gettasks

Parámetros de solicitud para verificar estado de 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 WhatsApp activa	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 tarea
`user_id`	ID de usuario
`status`	Estado de la tarea: `pending`: En cola y esperando `processing`: Actualmente procesando `exported`: Resultados disponibles para descarga
`total`	Total de números de teléfono procesados
`success`	Números identificados con éxito
`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`	`charge`, Solicitud exitosa, tarea creada o estado recuperado
`400`	`free`, Solicitud incorrecta, parámetros o formato de archivo inválido
`500`	`free`, Error interno del servidor, reintentar más tarde