API de detalles del verificador masivo de números WhatsApp

Compruebe si un número global es una cuenta WhatsApp registrada y obtenga información detallada del perfil.

URL de la API

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

Características principales

La API de detalles del verificador masivo de números WhatsApp ofrece capacidades completas de verificación:

Información de la cuenta

Información detallada de la cuenta WhatsApp, que incluye:

• Verificación del estado de la cuenta
• Firmas del usuario
• Marcas de tiempo de las actualizaciones de estado

Procesamiento en masa

Procese varios números a la vez mediante la subida de un archivo, lo que resulta eficiente para verificaciones a gran escala.

Actualizaciones de estado en tiempo real

Siga el progreso de sus tareas de verificación masiva con actualizaciones de estado en tiempo real.

Pasos de uso

Subida de archivo

Suba un archivo de texto con números de teléfono en formato E.164:

Ejemplo de petición

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

Parámetros de la petición

Comprobación de estado

Consulte el estado de procesamiento de su tarea:

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

Ejemplos de respuesta

Respuesta de creación de tarea

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Respuesta de estado en procesamiento

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Respuesta de tarea completada

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

Campos del resultado

Formato de respuesta de la API

Códigos de estado

Notas de integración

1. Cada línea del archivo de entrada debe contener un número de teléfono en formato E.164.

2. Supervise el estado de la tarea con el task_id proporcionado.

3. Descargue los resultados desde result_url cuando el estado sea “exported”.

4. Gestione adecuadamente los distintos códigos de estado en su aplicación.

Preguntas frecuentes

1. ¿Qué capacidad de procesamiento tiene la API?

La API puede procesar grandes lotes de números de forma eficiente, con actualizaciones en tiempo real sobre el progreso del procesamiento.

2. ¿En qué formato debe estar el archivo de entrada?

El archivo de entrada debe ser un archivo de texto con un número de teléfono por línea en formato E.164 (p. ej., +41798284651).

3. ¿Qué información devuelve la API?

La API devuelve información detallada de la cuenta, que incluye:

• Estado de la cuenta WhatsApp
• Firma del usuario (p. ej., “Hey there! I am using WhatsApp”)
• Marca de tiempo de la última actualización de estado

4. ¿Cuál es el precio de la API?

El precio es de $1.5 USD por 10.000 números para información detallada de cuentas WhatsApp, incluidas las actualizaciones de estado y las firmas.

Para más información sobre precios y procesamiento de mayores volúmenes, contáctenos.