API de Detalles del Verificador Masivo de WhatsApp: Información de Perfil y Estado

Verifique los detalles de WhatsApp del número global ingresado, si es una cuenta de WhatsApp, firma, actualización de estado.

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

curl --location 'https://api.checknumber.ai/wa/api/detail/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/detail/tasks/cs9viu7i61pkfs4oavvg' \
--header 'X-API-Key: API-KEY'

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/wa/api/detail/tasks

Parámetros de solicitud para cargar archivo

Parámetro	Descripción
user_id	string, ID de Usuario
file	file, Archivo de carga, cada línea debe contener un número de teléfono en formato E.164

URL de solicitud para verificar detalles de tarea

GET https://api.checknumber.ai/wa/api/detail/tasks/{TASK_ID}

Parámetros de solicitud para verificar detalles 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
signature	Firma del estado de WhatsApp	”Hey there! I am using WhatsApp”
status_update	Hora de última actualización de estado	2025-01-19
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 completed: Procesamiento finalizado 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