Detección (Array de Números)

POST/v1/detect

Envía un array de números para detección. Procesado de forma asíncrona.

HTTP 202 Accepted

Parámetros

Campo	Tipo	Requerido	Descripción
product	string	Sí	Slug del producto — Productos
country	string	Obligatorio para teléfono	Productos de teléfono: el código ISO 3166-1 alpha-2, por ejemplo CN o US. Productos de correo electrónico: omite este campo por completo. — Códigos de país
phones	array	Sí	Arreglo de números de teléfono o direcciones de correo electrónico de una sola serie.

Nota

El envío debe cumplir el mínimo del producto seleccionado —500, 1,000 o 2,000 según el producto, y se muestra en la lista de productos masivos— y mantenerse por debajo del máximo de la plataforma de 2,000,000. Un envío por debajo del mínimo se rechaza como too_few_numbers.

El país solo existe en los productos de teléfono

El correo electrónico no tiene dimensión de país. Enviar country con un producto de correo falla la validación. Es el espejo de los endpoints en tiempo real, donde country es opcional pero debe omitirse para el correo.

Ejemplo de Respuesta

{
  "mode": "async",
  "task_id": "xKj9aP3qLm7v",
  "idempotent_replay": false,
  "message": "Task queued. Poll GET /api/v1/tasks/xKj9aP3qLm7v for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 5000,
    "cost_deducted": 0.500000
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
mode	string	Siempre async para envíos masivos.
task_id	string	Token con el que consultas y descargas. Este es el parámetro de ruta {token} de los endpoints de tarea.
idempotent_replay	boolean	true cuando el envío reutilizó una tarea anterior en lugar de crear una nueva.
recovery_pending	boolean	true cuando la tarea está en cola pero su contabilidad aún se está conciliando.
message	string	Siguiente paso legible para humanos.
summary.total	integer	Filas aceptadas.
summary.cost_deducted	number	Monto prededucido para el envío.

Siguiente

• Envía un archivo en lugar de un arreglo
• Consulta el estado de la tarea hasta que termine