BreachDirectory ∙ API

Этот проект спонсирует:  

API

Многие предприятия только в 2018 году получил сотни миллионов штрафов за нарушение данных. Теперь, с вступлением в силу Общего регламента ЕС о защите данных (GDPR), штрафы могут быть еще выше.
Наш API может помочь вашей компании не стать следующей жертвой хакеров. Вы можете использовать API после предоставления доступа к ключу API, который можно использовать для включения нашей поисковой системы на ваш сайт.

Использование

Для каждого домена выдается только один ключ API.
Получив ключ API, вы можете использовать его следующим образом: /api_usage?domain=$Домен&api_key=$Ключ&method=$Метод&query=$Поисковый запрос&lang=ru
  • $Домен - домен вашего сайта, который вы присвоили своей учетной записи через панель управления пользователя;
  • $Ключ - ключ API, который вы получили от нас;
  • $Метод - метод поиска (в настоящее время доступны метода - домен ("domain"), электронная почта ("email"), имя пользователя ("username") и IP-адресы ("ip"));
  • $Поисковый запрос - Поисковый запрос.
  • Если запись найдена в нашей базе данных, мы вернем JSON-ответ «200 OK», который выглядит следующим образом (одна часть ответа предназначена для поста во взломе, другая - для информации о взломе):
    [
        {
            "title": "Test Data Breach",
    		"domain": "test.com",
            "email": "[email protected]",
            "username": "Username",
    		"ip": "127.0.0.1"
        }
    	{
    		"id": "ID",
    		"title": "test.com",
    		"domain": "test.com",
    		"breachdate_en": "0000",
    		"breachdate_ru": "0000",
    		"breachdate_lt": "0000",
    		"category_en": "Category",
    		"category_ru": "Категория",
    		"category_lt": "Kategorija",
    		"description_en": "Description",
    		"description_ru": "Описание",
    		"description_lt": "Aprašymas",
    		"compromised_data_en": "Compromised data",
    		"compromised_data_ru": "Скомпрометированные данные",
    		"compromised_data_lt": "Duomenys pavojuje",
    		"verified": "0 / 1",
    		"analyzed": "0 / 1",
    		"analysis_url_en": "Analysis URL",
    		"analysis_url_ru": "URL анализа",
    		"analysis_url_lt": "Analizės nuoroda",
    		"image": "Image"
    	}
    ]

    Сообщения об ошибках

    Если поиск не удастся, мы вернем сообщение об ошибке. Вот некоторые из них:
    A domain is required.
    когда API используется в неавторизованном домене;
    An API key is required.
    когда используемый вами ключ API отсутствует в нашей базе данных или срок его действия истек;
    A search method is required.
    когда метод поиска не указан;
    false
    когда поиск не дал результатов.