Detección (Subir Archivo)

POST/v1/detect/file

Sube un archivo TXT/CSV con un número por línea, máx 50 MB.

HTTP 202 Accepted

Parámetros

Content-Type: multipart/form-data

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
file	file	Sí	Archivo TXT o CSV, un número por línea, máximo 50 MB.

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": "qH5rZ7Lp3Wm9",
  "idempotent_replay": false,
  "message": "File queued (10000 numbers). Poll GET /api/v1/tasks/qH5rZ7Lp3Wm9 for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 10000,
    "cost_deducted": 1.000000
  }
}

Campos de la respuesta

Detección (Array)