Проверка номеров (массив)

POST/v1/detect

Отправьте массив номеров для проверки. Обрабатывается асинхронно.

HTTP 202 Accepted

Параметры

Поле	Тип	Обязательно	Описание
product	string	Да	Slug продукта — Продукты
country	string	Обязательно для телефонов	Телефонные продукты: код ISO 3166-1 alpha-2, например CN или US. Email-продукты: полностью опустите это поле. — Коды стран
phones	array	Да	Массив телефонных номеров или email-адресов из одной серии.

Заметка

Отправка должна соответствовать минимуму выбранного продукта — 500, 1,000 или 2,000 в зависимости от продукта, он указан в пакетном списке продуктов — и не превышать максимум платформы 2,000,000. Отправка ниже минимума отклоняется с too_few_numbers.

Country есть только у телефонных продуктов

У email нет измерения страны. Отправка country с email-продуктом не проходит валидацию. Это зеркало эндпоинтов реального времени, где country необязателен, но для email его нужно опустить.

Пример ответа

{
  "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
  }
}

Поля ответа

Поле	Тип	Описание
mode	string	Всегда async при пакетных отправках.
task_id	string	Токен, с которым вы опрашиваете статус и скачиваете результат. Это параметр пути {token} эндпоинтов задачи.
idempotent_replay	boolean	true, если отправка переиспользовала более раннюю задачу вместо создания новой.
recovery_pending	boolean	true, если задача поставлена в очередь, но её учёт ещё сводится.
message	string	Следующий шаг в читаемом виде.
summary.total	integer	Принято строк.
summary.cost_deducted	number	Сумма, предварительно списанная за отправку.

Дальше

• Отправить файл вместо массива
• Опрашивайте статус задачи, пока работа не завершится