API de comprobación de MAX: verificación masiva de números de teléfono

Compruebe si los números de teléfono de su archivo están registrados en MAX Messenger (oneme.ru). Sigue el mismo flujo de tareas por lotes que los demás comprobadores de redes sociales y mensajería.

Ejemplo de carga del archivo de comprobación:

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

Ejemplo de consulta del estado de la tarea:

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

Respuesta cuando la carga se realiza correctamente

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2026-05-18T11:00:00.000000000Z"
}

Respuesta durante el procesamiento

{
    "created_at": "2026-05-18T11:00:00.000Z",
    "updated_at": "2026-05-18T11:01:30.000Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Respuesta al finalizar (exported)

{
    "created_at": "2026-05-18T11:00:00.000Z",
    "updated_at": "2026-05-18T11:03:00.000Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip"
}

URL de solicitud para cargar el archivo

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

Parámetros de la solicitud de carga

Parámetro	Descripción
file	file, un número de teléfono por línea (formato E.164, por ejemplo, +79991234567)
task_type	string, establézcalo en max

Tamaño mínimo de lote: 1000 números por tarea.

URL de solicitud para consultar el estado de la tarea

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

Parámetros de la solicitud de estado

Parámetro	Descripción
task_id	string, ID de tarea devuelto al crearla

Campos del resultado

Campo	Descripción	Ejemplo
Number	Número de teléfono en formato E.164	+79991234567
max	Indica si el número está registrado en MAX Messenger	yes, no

Formato de respuesta

Campo	Descripción
created_at	Marca de tiempo de creación de la tarea
updated_at	Marca de tiempo de la última actualización de estado
task_id	Identificador único de la tarea
user_id	ID de usuario
status	pending · processing · exported
total	Total de números de teléfono procesados
success	Números identificados correctamente
failure	Números cuyo procesamiento falló
result_url	URL de descarga cuando status es exported

Códigos de estado

Estado	Descripción
200	charge, solicitud correcta
400	free, solicitud no válida
500	free, error del servidor