CheckNumber.AI· 2 min read
API de detalles del verificador masivo de números WhatsApp
Compruebe si un número global está en WhatsApp y obtenga información detallada del perfil, incluidas firmas y actualizaciones de estado.
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 ofrece capacidades completas de verificación:
Información de la cuenta
Información detallada de la cuenta WhatsApp: verificación de estado, firmas del usuario y marcas de tiempo de actualización de estado.
Procesamiento en masa
Procese varios números a la vez mediante subida de archivo, eficiente para verificaciones a gran escala.
Actualizaciones de estado en tiempo real
Siga el progreso de sus tareas de verificación masiva en tiempo real.
Pasos de uso
Subida de archivo
Suba un archivo de texto con números 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
| Parámetro | Tipo | Descripción |
|---|---|---|
file | file | Archivo con números a verificar, un número por línea |
task_type | string | ws_active — actividad / firma |
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
La API devuelve objetos JSON con created_at, updated_at, task_id, status, total, success, failure y, cuando el estado es “exported”, result_url.
Campos del resultado
| Campo | Descripción |
|---|---|
Number | Número en formato E.164 |
signature | Firma del estado WhatsApp |
status_update | Hora de la última actualización de estado |
whatsapp | Si el número tiene cuenta WhatsApp activa |
Códigos de estado
| Estado | Descripción |
|---|---|
200 | Petición correcta, tarea creada o estado obtenido (de pago) |
400 | Petición incorrecta, parámetros o formato inválidos (gratis) |
500 | Error interno del servidor, intente más tarde (gratis) |
Notas de integración
- Cada línea del archivo debe contener un número en formato E.164.
- Consulte el estado de la tarea con el
task_idproporcionado. - Descargue los resultados desde
result_urlcuando el estado sea “exported”. - Gestione 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 con actualizaciones de estado en tiempo real.
2. ¿En qué formato debe estar el archivo de entrada?
Archivo de texto con un número por línea en formato E.164 (p. ej. +41798284651).
3. ¿Qué información devuelve la API?
Devuelve estado de la cuenta WhatsApp, firma del usuario (p. ej. “Hey there! I am using WhatsApp”) y marca de tiempo de la última actualización de estado.
4. ¿Cuál es el precio?
El precio es 2 USD por 10.000 números para información detallada (actualizaciones de estado y firmas).
Para más información sobre precios y volúmenes mayores, contáctenos.