BreachDirectory ∙ Документация по API

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

API

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

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

Вы можете использовать API следующим образом: /api_usage?key=$Ключ&method=$Метод&query=$Поисковый запрос&lang=ru
  • $Домен - домен вашего сайта (в настоящее время домен не требуется: функция может быть повторно реализована позже.);
  • $Метод - метод поиска (в настоящее время доступны метода - домен ("domain"), электронная почта ("email"), имя пользователя ("username") и IP-адресы ("ip"));
  • $Ключ - Ключ API получен при покупке доступа к API.
  • $Поисковый запрос - Поисковый запрос.
  • Все пользователи API должны использовать службу только для повышения безопасности своих услуг или предложений продуктов, защиты своих учетных данных API, обеспечения защиты любой информации, полученной через API BreachDirectory или любых других служб, от несанкционированного доступа, и следовать всем применимые законы, относящиеся к их юрисдикции.
    Если запись найдена в нашей базе данных, мы вернем 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 используется в неавторизованном домене (в настоящее время указывать свой домен не нужно: достаточно ключа API.);
    A search method is required.
    когда метод поиска не указан;
    Invalid or Expired API Key.
    когда используемый ключ API недействителен или просрочен;Или
    false
    или пустой массив:
    []
    когда поиск не дал результатов.