Получение списков Safe Browsing

Запрос возвращает информацию об актуальных списках Safe Browsing, хранящихся на серверах Яндекса.

Списки Safe Browsing состоят из префиксов хэшей SHA-256 произвольной длины (от 4 до 32 байт), которые соответствуют URL интернет-ресурсов, представляющих угрозу для пользователя. Каждый список идентифицируется параметрами:

• вид предполагаемой угрозы;
• платформа, которой угрожает опасность;
• тип объекта, представляющего угрозу.

Списки формирует и поддерживает Яндекс. Принцип вычисления хэшей см. в разделе URL и хэширование.

Формат запроса

GET https://sba.yandex.net/v4/threatLists
  ? key=<API-ключ>

* Обязательный параметр

Формат ответа приведен ниже. Порядок следования и наличие элементов не гарантируется. В ответе могут присутствовать служебные параметры, которые не описаны в документе.

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

Тело ответа содержит перечень всех актуальных списков Safe Browsing с параметрами, которые идентифицируют каждый из них.

Полученные значения используются в параметрах запросов:

• Lookup. Проверка по URL;
• Update. Обновление локальной базы списков Safe Browsing;
• Update. Проверка по хэшу.

{
  "threatLists": [
    { 
      "threatType": "{еnum}",
      "platformType": "{еnum}",
      "threatEntryType": "{еnum}"
    }
  ]
}

threatType*

Вид угрозы. Возможные значения: THREAT_TYPE_UNSPECIFIED —  неизвестная угроза. MALWARE —  вредоносное программное обеспечение. SOCIAL_ENGINEERING —  угрозы социальной инженерии. UNWANTED_SOFTWARE —  нежелательное программное обеспечение. POTENTIALLY_HARMFUL_APPLICATION —  потенциально опасное приложение.

platformType*

Платформа, которая подвергается угрозе. Возможные значения: PLATFORM_TYPE_UNSPECIFIED —  платформа неизвестна. WINDOWS —  Windows. LINUX —  Linux. ANDROID —  Android. OSX —  OS X. IOS —  iOS. ANY_PLATFORM —  минимум одна платформа из списка. ALL_PLATFORMS —  все платформы. CHROME —  Chrome.

threatEntryType*

Тип объекта, который представляет угрозу. Возможные значения: THREAT_ENTRY_TYPE_UNSPECIFIED —  тип неизвестен. URL —  URL. EXECUTABLE —  исполняемая программа.

* Обязательный параметр

Пример

Запрос:

https://sba.yandex.net/v4/threatLists?key=2f8...8ea

Ответ:

{
  "threatLists": [
    {
      "threatType": "MALWARE",
      "platformType": "WINDOWS",
      "threatEntryType": "URL"
    },
    {
      "threatType": "MALWARE",
      "platformType": "LINUX",
      "threatEntryType": "URL"
    }
  ]
}