BigTrace API

v1.0 — /api/v1

API для проверки данных: банковские карты, номера телефонов и другие данные. Поддерживает пакетную обработку.

Base URL /api/v1 Версия 1.0 Формат JSON / text

Аутентификация

Большинство методов требуют передачи заголовка:
Authorization: username:token

Токен создаётся через POST /api/v1/newtoken или в панели управления.
Строка подключения выглядит так: логин:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Что такое BigTrace?

Инструмент для массовой проверки данных через единый API

Зачем это нужно

Когда нужно проверить один номер телефона — это просто. Когда их тысячи, нужен инструмент.

BigTrace принимает списки данных — номера телефонов, банковские карты, email-адреса, IP и URL — и возвращает структурированный результат по каждому: валиден ли формат, существует ли объект, к какому оператору или банку относится, в каких мессенджерах зарегистрирован.

Что можно проверить

Телефоны — валидность формата, страна, оператор, тип линии (мобильный / фиксированный / VoIP), регион, часовые пояса, наличие в WhatsApp.

Банковские карты — проверка по алгоритму Луна, информация о BIN: платёжная система, банк-эмитент, страна, тип карты.

Email, IP, URL — валидность формата и базовая проверка существования.

Как использовать

Есть два способа работы:

API — отправляете POST-запрос со списком данных, получаете JSON. Подходит для интеграции в свои системы и автоматизации.

BigTrace CLI — приложение для Windows с графическим интерфейсом и консольным режимом. Загружаете файл (CSV, Excel, TXT), запускаете проверку, получаете результат в файл. Не требует написания кода.

Модель оплаты

Оплата за фактически выполненные проверки. Пополняете баланс на нужную сумму и расходуете по мере использования — без подписок и минимальных списаний.

Начало работы

Следуйте этим шагам, чтобы начать использовать BigTrace

Скачайте BigTrace CLI

Скачайте приложение для Windows. Это графический клиент с консольным режимом.

Скачать BigTrace CLI

Создайте API токен

Перейдите в панель управления и создайте новый токен. После создания скопируйте строку подключения:

логин:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Подключитесь через GUI

Запустите скачанный app.exe, вставьте строку подключения в соответствующее поле и нажмите Сохранить. Приложение готово к работе.

Консольный режим (опционально)

Та же программа поддерживает запуск из командной строки:

# Подключение / авторизация

bigtrace connect <строка подключения>

# Пробить список номеров из файла

bigtrace phones input.csv output.csv

Поддерживаемые форматы: .csv, .txt, .xls, .xlsx, .ods

Базовый API

GET /api/v1/ping

Проверка доступности

Ответы

200 Возвращает строку "pong"

Базовый API

GET /api/v1/status

Статус сервера

Ответы

200 Возвращает строку "ok"

Базовый API

POST /api/v1/newaccount

Создание аккаунта

Создаёт новый аккаунт. Возвращает UUID первого токена.

Body

application/json Данные нового аккаунта

{"username": "user1", "password": "pass"}

Ответы

200 Токен (UUID строка)

400 Аккаунт с таким именем уже существует

500 Ошибка сервера

Базовый API

POST /api/v1/newtoken

Создание токена

Требует авторизации: username:password

Создаёт новый API-токен для аккаунта.

Headers

Имя	Тип	Обязательный	Описание	Пример
Authorization	string	YES	Учётные данные	username:password

Ответы

201 Новый токен (UUID строка)

403 Неверные учётные данные

Базовый API

GET /api/v1/balance

Баланс аккаунта

Требует авторизации: username:token

Headers

Имя	Тип	Обязательный	Описание	Пример
Authorization	string	YES	Учётные данные	username:token

Ответы

200 Баланс в виде числа с плавающей точкой

403 Неверные учётные данные

Базовый API

GET /api/v1/addbalance

Пополнить баланс

Требует авторизации: username:token

Создаёт платёж через платёжную систему. Возвращает URL страницы оплаты.

Query Parameters

Имя	Тип	Обязательный	Описание	Пример
amount	integer	YES	Сумма пополнения в рублях	100

Headers

Имя	Тип	Обязательный	Описание	Пример
Authorization	string	YES	Учётные данные	username:token
return	string	—	URL для редиректа после успешной оплаты

Ответы

200 URL платёжной страницы

403 Неверные учётные данные

Проверки

POST /api/v1/trace/phone/1

Проверка номера телефона (уровень 1)

Требует авторизации: username:token

Базовая проверка номера телефона. Проверяет валидность, страну, оператора, тип линии и наличие в мессенджерах.

Path Parameters

Имя	Тип	Обязательный	Описание	Пример
family	string	YES	Тип данных для проверки	phone
level	string	YES	Уровень проверки (для phone: 1 - базовая)	1

Query Parameters

Имя	Тип	Обязательный	Описание	Пример
expect	string[]	—	Фильтр по статусам результата: valid, hlr, messengers	valid
language	string	—	Язык ответа (ISO 639-1)	RU

Headers

Имя	Тип	Обязательный	Описание	Пример
Authorization	string	YES	Учётные данные	username:token

Body

text/plain Номера телефонов для проверки, по одному на строку

+79991234567 +79998765432

Ответы

200 JSON массив результатов с данными: valid, exist, legit, status, country, carrier, line_type, time_zones, region, messengers (WhatsApp), cost

403 Неверные учётные данные или недостаточно средств

500 Ошибка сервера

Поля ответа

Полный JSON-ответ содержит:

data.valid — валидность формата номера
data.exist — наличие номера в сети (HLR)
data.legit — легитимность (валид + наличие)
data.status — список статусов проверок
data.cost — стоимость проверки
country — страна (например, "Russia")
country_code — код страны (например, "7")
carrier.name — название оператора
carrier.net — название сети
carrier.mcc — код страны в сети
carrier.mnc — код оператора
line_type — тип линии (mobile/fixed/voip и т.д.)
time_zones — часовые пояса
region — регион
messengers.whatsApp — наличие в WhatsApp

BigTrace CLI

GUI BigTrace CLI

Графический интерфейс

Простой и понятный интерфейс для проверки данных. Подходит для новичков и тех, кто предпочитает графический интерфейс.

Body

application Графическое приложение для Windows

app.exe

Ответы

200 Приложение запущено и готово к работе

Как использовать графический интерфейс

Пошаговая инструкция:

Запустите приложение app.exe
В главном окне введите строку подключения: логин:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Нажмите кнопку Сохранить
Выберите тип проверки (телефоны, карты, email и т.д.)
Нажмите Выбрать файл и укажите входной файл
Укажите выходной файл для результатов
Нажмите Начать проверку
Дождитесь завершения и откройте результаты

BigTrace CLI

CLI bigtrace connect

Подключение к серверу

Подключение к серверу через строку подключения. Сохраняется в настройки приложения.

Body

command Строка подключения: логин:token

bigtrace connect user1:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Ответы

200 Подключение успешно

403 Неверная строка подключения

Как использовать консольный режим

Формат входного файла (txt/csv):

+79991234567 +79998765432 +79991112233

Примеры команд:

bigtrace connect user1:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx bigtrace phones input.txt output.csv bigtrace cards input.csv output.json bigtrace emails input.xlsx output.csv bigtrace balance

Поддерживаемые форматы: .csv, .txt, .xls, .xlsx, .ods

BigTrace CLI

CLI bigtrace phones

Проверка телефонов из файла

Проверка телефонов из CSV, TXT, XLS, XLSX или ODS файла. Результаты сохраняются в выходной файл.

Body

command Формат входного файла: один номер на строку

bigtrace phones input.csv output.csv

Ответы

200 Проверка завершена, результаты сохранены

400 Ошибка чтения входного файла

500 Ошибка при проверке

Как использовать консольный режим

Формат входного файла (txt/csv):

+79991234567 +79998765432 +79991112233

Примеры команд:

bigtrace connect user1:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx bigtrace phones input.txt output.csv bigtrace cards input.csv output.json bigtrace emails input.xlsx output.csv bigtrace balance

Поддерживаемые форматы: .csv, .txt, .xls, .xlsx, .ods

BigTrace CLI

CLI bigtrace cards

Проверка карт из файла

Проверка банковских карт из CSV, TXT, XLS, XLSX или ODS файла. Результаты сохраняются в выходной файл.

Body

command Формат входного файла: один номер карты на строку

bigtrace cards input.txt output.json

Ответы

200 Проверка завершена, результаты сохранены

400 Ошибка чтения входного файла

500 Ошибка при проверке

Как использовать консольный режим

Формат входного файла (txt/csv):

+79991234567 +79998765432 +79991112233

Примеры команд:

bigtrace connect user1:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx bigtrace phones input.txt output.csv bigtrace cards input.csv output.json bigtrace emails input.xlsx output.csv bigtrace balance

Поддерживаемые форматы: .csv, .txt, .xls, .xlsx, .ods

BigTrace CLI

CLI bigtrace emails

Проверка email из файла

Проверка email-адресов из CSV, TXT, XLS, XLSX или ODS файла. Результаты сохраняются в выходной файл.

Body

command Формат входного файла: один email на строку

bigtrace emails input.xlsx output.csv

Ответы

200 Проверка завершена, результаты сохранены

400 Ошибка чтения входного файла

500 Ошибка при проверке

Как использовать консольный режим

Формат входного файла (txt/csv):

+79991234567 +79998765432 +79991112233

Примеры команд:

bigtrace connect user1:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx bigtrace phones input.txt output.csv bigtrace cards input.csv output.json bigtrace emails input.xlsx output.csv bigtrace balance

Поддерживаемые форматы: .csv, .txt, .xls, .xlsx, .ods

BigTrace CLI

CLI bigtrace balance

Проверка баланса

Показывает текущий баланс аккаунта.

Body

command Команда для проверки баланса

bigtrace balance

Ответы

200 Баланс отображён в консоли

Как использовать консольный режим

Формат входного файла (txt/csv):

+79991234567 +79998765432 +79991112233

Примеры команд:

bigtrace connect user1:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx bigtrace phones input.txt output.csv bigtrace cards input.csv output.json bigtrace emails input.xlsx output.csv bigtrace balance

Поддерживаемые форматы: .csv, .txt, .xls, .xlsx, .ods