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

Verifica los detalles del Zalo del número global ingresado, si es una cuenta de Zalo

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="zalo"'

Ejemplo de código para verificar el estado de la 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

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Respuesta para el estado de procesamiento

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Proporcione una respuesta indicando que la tarea está completa e incluya la URL de descarga de los resultados.

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

URL de solicitud de carga de archivo

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

Parámetros de solicitud de carga de archivo

Parámetro	Descripción
file	file, Cargar archivo, cada línea debe contener un número de teléfono en formato E.164
task_type	string, Tipo de tarea, establecido en “zalo”

URL de solicitud de verificación del estado de la tarea

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

Parámetros de solicitud de verificación del estado de la tarea

Parámetro	Descripción
task_id	string, ID de tarea devuelto desde la creación de la tarea

Campos de Resultado

Campo	Descripción	Ejemplo
Number	Número de teléfono en formato E.164	+84901234567
zalo	Si el número tiene una cuenta Zalo 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 la tarea
user_id	ID de usuario
status	Estado de la tarea: pending: En cola y esperando processing: Procesando actualmente exported: Resultados disponibles para descargar
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 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 o formato de archivo no válidos
500	free, Error interno del servidor, intente más tarde