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

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

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

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

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

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

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

key *

Значение API-ключа.

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

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

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

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

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

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

threatLists

Актуальные списки Safe Browsing. Массив объектов.

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"
    }
  ]
}