📘 Документация API

📌 Описание

API предназначено для анализа и поиска утекших данных с поддержкой гибкой фильтрации, поиска по хешам (SHA-256), а также комбинирования условий, включая фильтрацию по диапазонам дат.

🔄 Данные обновляются ежедневно, что обеспечивает актуальность информации и позволяет компаниям своевременно реагировать на потенциальные угрозы. Использование нашего API предоставляет следующие преимущества:

🛡 Усиленная защита клиентов и сотрудников — позволяет выявить компрометированные данные до их использования злоумышленниками.
🚨 Раннее реагирование на инциденты — реагируйте до того, как проблема станет критической.
🔐 Поиск без раскрытия чувствительных данных — проверка через хеши позволяет сохранять конфиденциальность.
📊 Гибкий анализ утечек — возможность настроить сложные условия поиска по множеству параметров.
⚙️ Простая интеграция — подключается к существующим системам безопасности (SIEM, SOC, DLP).
📈 Повышение доверия клиентов и деловых партнёров — вы демонстрируете активную политику защиты данных.
⚡ Высокая производительность — API обрабатывает миллионы записей за секунды.

Интеграция с нашим API — это не просто техническое решение, а стратегическая мера для защиты бизнеса, репутации и клиентов.

Ваш уникальный токен авторизации:

Внимание: этот токен является персональным ключом доступа. Не передавайте его третьим лицам и не публикуйте в открытых источниках.

🔧 Пример простого запроса

POST /api/v2/search
Authorization: Bearer <ваш токен>

curl -X POST https://cyberprotections.org/api/v2/search \
  -H "Authorization: Bearer <ваш токен>" \
  -H "Content-Type: application/json" \
  -d '{"clearUsername": "admin23"}'

🔍 Поля, доступные для поиска

Поле	Описание	Пример	Пример хеша
clearUsername	Логин или юзернейм	user12345	hash_clearUsername
password	Пароль	Qwerty123!	—
ip	IP-адрес	192.168.0.1, 192.168.0., 192.168..*	hash_ip
phone	Телефон	380501234567	hash_phone
clearDomen	Домен (1 уровень)	facebook.com	hash_clearDomen
domainZone	Зона домена (ISO 3166)	com, ru, gov.ru	—
clearEmail	Почта в нижнем регистре	[email protected]	hash_clearEmail
emailDomain	Домен почты	gmail.com	—
countryPhone	Код страны (ISO формат)	UA, RU, US	—
data_modify	Дата источника	{ "from": "2023-01-01", "to": "2023-12-31" }	—

🧪 Примеры запросов с условиями

🔍 Поиск российских телефонов, авторизованных на binance.com за указанный период

{
  "clearDomen": "binance.com",
  "countryPhone": "RU",
  "data_modify": { "from": "2024-01-01", "to": "2025-01-01" }
}

🔍 Поиск пользователей сайта diia.gov.ua у которых почтовые ящики gmail.com

{
  "clearDomen": "diia.gov.ua",
  "emailDomain": "gmail.com"
}

🔍 Поиск аккаунтов с логином root по стране RU за период

{
  "clearUsername": "root",
  "countryPhone": "RU",
  "data_modify": { "from": "2024-01-01", "to": "2025-12-31" }
}

🔍 Поиск корпоративных IP-адресов по маске в зоне RU

{
  "ip": "10.10.*.*",
  "domainZone": "ru"
}

🔍 Поиск по хешу почты

{
  "hash_clearEmail": "38df3760f878e373222d4543245529c560049a3aef14a8acb47831eeef135ef4"
}

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

{
  "password": "admin123"
}

🔍 Поиск контактов с телефонами UA, посещавших сайты в зоне .ru за период

{
  "countryPhone": "UA",
  "domainZone": "ru",
  "data_modify": { "from": "2023-01-01", "to": "2025-05-01" }
}

📦 Формат ответа

{
  "success": true,
  "updatedCredits": 5589,
  "results": [
    { "_id": "6801837abdde957f1bcf3422", ... }
  ],
  "total": 1000
}

🏢 Интеграция для банков и компаний

Для корпоративных клиентов реализована защищённая проверка утечек без раскрытия чувствительных данных клиентов и сотрудников. Это позволяет:

✅ Обеспечить безопасность пользователей и предотвращение утечек
✅ Оперативно реагировать на инциденты до их масштабного воздействия
✅ Проверять утечки без раскрытия персональных данных (через хеши)
✅ Интегрировать API в существующие системы мониторинга и SOC
✅ Использовать хеши логинов, паролей, email, телефонов, ip и т.д.
✅ Проверять миллиарды записей за секунды
✅ Полный контроль — данные клиента не передаются в чистом виде

Все значения должны быть приведены к нижнему регистру перед хешированием (SHA-256). Используйте поля hash_... для запроса.

❗ Ошибки API

401 Unauthorized — не передан токен авторизации
403 Forbidden — токен недействителен или недостаточно кредитов
400 Bad Request — не передан ни один параметр для поиска
500 Internal Server Error — ошибка сервера или базы данных