Типичный сценарий
Отправьте массив номеров для проверки. Обрабатывается асинхронно.
Эндпоинты кратко
Заголовок раздела «Эндпоинты кратко»| Эндпоинты | Описание |
|---|---|
GET /v1/balance | Возвращает текущий баланс USD. |
POST /v1/detect | Отправьте массив номеров для проверки. Обрабатывается асинхронно. |
POST /v1/detect/file | Загрузите TXT/CSV файл, один номер на строку, до 50 МБ. |
GET /v1/tasks/{token} | Опрашивайте задачу каждые 3–5 секунд до completed или failed. |
GET /v1/tasks/{token}/result | Получите ссылку для скачивания результата. Файлы хранятся 7 дней по умолчанию (настраивается через result_retention_days). |
GET /v1/tasks/{token}/download | Напрямую отдаёт готовый файл с результатами как вложение. Можно перейти по download_url из эндпоинта результата либо вызвать этот эндпоинт с тем же токеном задачи. |
HTTP 202 Accepted
Перед отправкой
Заголовок раздела «Перед отправкой»- Отправка должна соответствовать минимуму выбранного продукта — 500, 1,000 или 2,000 в зависимости от продукта, он указан в пакетном списке продуктов — и не превышать максимум платформы 2,000,000. Отправка ниже минимума отклоняется с
too_few_numbers. - Телефонные продукты: код ISO 3166-1 alpha-2, например
CNилиUS. Email-продукты: полностью опустите это поле. — Коды стран