BREACHka Проверьте вашу безопасность в крупнейшей базе рунета.

Приложение для массового поиска и взаимодействия с апи

У нашего сервиса есть Api, благодаря которому вы можете сделать самостоятельное решение по использованию данных для своих задач. Однако, не всем удобно реализовывать персональное решение или нанимать программистов для этого.

В связи с этим, мы разработали десктопное приложение, через которое вы можете запрашивать большие объемы данных - 50 000 идентификаторов за раз и сохранять полученный результат сразу у себя на компьютере в форматах: *.xlsx *.csv *.json.

Что бы понять, что вы можете получить через приложение вы можете зайти на страницу Массового поиска. Данный раздел сайта организован также как и приложение и через него можно получить примеры файлов которые будут идентичны тем файлам которые выдает приложение.

Скачать приложение BREACHka

Скачать для Windows
как запустить на Windows

Скачать для Linux
как запустить на Ubuntu/Debian

Инструкция

Для использования приложения необходимо приобрести пакет запросов или премиум доступ.
Пакеты запросов и премиум доступ можно использовать через все наши решения: сайт, Telegram бот, API и десктопное приложение - баланс един.
Если у вас куплен и премиум доступ и пакет запросов, то сначала будут расходоваться запросы из премиума (первые 100 шт в сутки) и только затем, в случае превышения этого лимита, из пакета запросов.

Настраиваем приложение для работы

Заходим в личный кабинет на сайте и копируем от туда API key (он находится в разделе API и баланс запросов).
Запускаем десктопное приложение и открываем вкладку Настройки.
Вставляем скопированный с сайта API key в приложение, в графу API key и нажимаем кнопку Сохранить.
Нажимаем кнопку Получить информацию о пользователе - в результате нажатия на кнопку, вы должны увидеть информацию о своем пользователе ниже. Пример успешной настройки приложения смотрите на изображении ->

В случае если в поле под кнопкой Получить информацию о пользователе вы не видите данные своего аккаунта, как показано на изображении, или вы увидели сообщение об ошибке, то проделайте следующие действия:

перезапустите приложение;
скопируйте и вставьте токен повторно;
повторно сохраните настройки;
запросите получение информации о пользователе.

Если токен указан верный, то с большой вероятностью доступ к Api блокирует ваш интернет провайдер - используйте VPN.

Если VPN не помог решить проблему доступа к Api - обратитесь в техническую поддержку сервиса @BreachkaSup

Подготавливаем файл для запроса

Приложение работает с текстовыми файлами *.txt - обычные файлы блокнота Windows или аналогичных систем.
Каждый идентификатор внутри файла запроса необходимо писать с новой строки.
Не допускается использование запятых или других разделителей, просто пишите: один запрос - одна строка.
Число запросов в файле запроса должно быть от 1 до 50 000
Пример заполнения поля:

Описание	Пример запроса
ФИО	`Иванов Петр Петрович 06.04.1994` `Иванов Петр Петрович 1994`	Для поиска по ФИО необходимо прислать его в формате: `Фамилия Имя Отчество пробел дд.мм.гггг` Допускается прислать ФИО с годом рождения `Фамилия Имя Отчество пробел гггг` - Порядок ФИО строго обязателен, запрос должен быть организован именно в формате сначала фамилия, потом имя, а только потом отчество - Дата рождения присылается через пробел от Отчества, в формате: день месяца точка месяц точка год - Год рождения присылается через пробел от Отчества, в формате: год (4 знака)
Номер	`79258004623`
Email	`novoselov@mail.ru`
Пароль	`pas qwerty1`	Для поиска по паролю обязательно его прислать в формате: `pas пробел пароль` Код pas в начале запроса строго обязателен, чтобы система поняла что вы прислали. Пробел между pas и паролем необходим системе для отделения кода запроса от самого запроса.
Паспорт	`pasp 9808197477`	Для поиска по паспорту обязательно его прислать в формате: `pasp пробел №паспорта` Код pasp в начале запроса строго обязателен, чтобы система поняла что вы прислали. Пробел между pasp и №паспорта необходим системе для отделения кода запроса от самого запроса. Присылайте № паспорта без пробелов, дефисов и прочих символов, только цифры (или бувы и цифры) если к проверке планируется паспорт отличный от стандартного паспорта РФ, например паспорт Украины или загран.
ИНН	`inn 141002515301`	Для поиска по ИНН обязательно его прислать в формате: `inn пробел №ИНН` Код inn в начале запроса строго обязателен, чтобы система поняла что вы прислали. Пробел между inn и №ИНН необходим системе для отделения кода запроса от самого запроса. Присылайте №ИНН без пробелов, дефисов и прочих символов, только цифры.
СНИЛС	`snils 12259959991`	Для поиска по СНИЛС обязательно его прислать в формате: `snils пробел №СНИЛС` Код snils в начале запроса строго обязателен, чтобы система поняла что вы прислали. Пробел между snils и №СНИЛС необходим системе для отделения кода запроса от самого запроса. Присылайте №СНИЛС без пробелов, дефисов и прочих символов, только цифры.
Автомобиль	`Р900ХН150`
VIN	`JF1SG9LT57G096640`
TG ID	`#id2035261767`
TG UserName	`@o188rs`
Вконтакте	`https://vk.com/id580392`

Поиск

Переходим на вкладку Поиск в приложении.
Выбираем нужный вам Формат выдачи
В ответе сервиса, вы можете получить 3 формата выдачи:
- Сводная информация: выдача будет объединена по полям ответа и вы получите все имена в одном поле, все адреса в одном поле и тд;
- Подробная информация: выдача будет разделена согласно источнику откуда она получена, вы получите каждое имя, адрес и тп в разных полях;
- Источники: будет прислан перечень источников.
Для того что бы понять какой из типов запросов вам подойдет больше, вы можете протестировать форматы выдачи:
- На главной странице сайта;
- Через Массовый поиск.
Поле Страна поиска

Данный параметр распространяется сразу на все идентификаторы что есть в запросе.
Этот параметр учитывается только для двух типов запросов: ФИО и ИНН
Если вы не используете идентификаторы указанных типов в запросе, то просто не обращайте внимания на это поле.
Поле Тип итогового файла

Запрос можно сохранить в трех форматах:
- Excel, расширение файла *.xlsx, подойдет для работы и обобщения полученных данных;
- CSV, расширение файла *.csv, подойдет для тех кто привык работать с таблицами, но не хочет использовать решения от Microsoft;
- Json, расширение файла *.json, подойдет для дальнейшей загрузки полученной информации в свою базу данных, а так же автоматизированной обработки информации.
Нажимаем кнопку Поиск и выбираем текстовый файл с заданием
Ожидаем выполнения задачи, в поле Лог выполнения будет отображен прогресс получения данных

Результат

В результате выполнения задания, программа сохранит в той же папке, где лежал исходный файл от 1 до 2 итоговых файлов.

Первый файл - обычно создается только он, это файл с результатом выполненного задания.
Структура его названия: <имя файла задания>_<формат выдачи>_Responses.<тип итогового файла>.
Например: Текстовый документ_Summary_Responses.xlsx или Текстовый документ_Detail_Responses.json
Второй файл - создается в случае если в запросе были идентификаторы которые не прошли валидацию.
Структура его названия: <имя файла задания>_<формат выдачи>_NotValidRequests.txt.
Например: Текстовый документ_Summary_NotValidRequests.txt - это всегда текстовый файл.

Особенности работы программы

В процессе выполнения работы, программа пошагово выполняет сохранение полученных данных, итерация за итерацией, в связи с этим, при обработке большого файла в случае зависания или отключения интернета все что было обработано программой уже будет сохранено в итоговом файле.
В случае появления необходимости выключить обработку файла задания просто закройте программу, вся информация по запросам, которые отработали до закрытия приложения уже сохранена в результирующем файле.

Как запустить программу на Windows

Скачиваем архив, если не скачали ранее, по ссылке
Извлекаем содержимое архива - это очень важный шаг, для корректной работы программа должна быть разархивирована
PS: Внутри архива *.zip что вы скачаете, будет лежать еще один архив *.tar - распаковать надо и его, таким образом что бы вы увидели внутри папки файлы программы (см. картинку).
Открываем распакованную папку и запускаем файл ApiApp.Desktop.exe
Настраиваем приложение для работы путем вставки своего Api key - как настроить

Как запустить программу на Linux (Ubuntu/Debian)

Скачиваем архив, если не скачали ранее, по ссылке
Извлекаем содержимое архива - это очень важный шаг, для корректной работы программа должна быть разархивирована
Открываем папку и запускаем файл ApiApp.Desktop через графический интерфейс, как показано на изображении
Настраиваем приложение для работы путем вставки своего Api key - как настроить
Если по какой-то причине у вас нет пункта запуска приложения в контекстном меню то его можно запустить через терминал, для этого:
- В терминале переходим в папку с приложением:
```
cd /path/to/your/application
```
- Запускаем приложение введя команду:
```
./ApiApp.Desktop
```
- Если приложение не запускается:
  - Убедитесь, что файл приложения имеет права на выполнение:
```
chmod +x /path/to/your/application/ApiApp.Desktop
```
  - Проверьте наличие библиотек, таких как libX11, libinput, libgbm. Убедитесь, что они установлены в вашей системе, для этого выполните:
```
sudo apt update
```
```
sudo apt install libx11-dev libinput-dev libgbm-dev libudev-dev
```