Kaspersky Threat Intelligence Portal

Поиск веб-адресов

Развернуть все | Свернуть все

Kaspersky Threat Intelligence Portal предоставляет API для анализа веб-адресов.

Запрос

Метод запроса: GET

Конечная точка: https://opentip.kaspersky.com/api/v1/search/url

Параметр запроса: request – веб-адрес, который требуется проанализировать.

Пример команды cURL:

curl --request GET 'https://opentip.kaspersky.com/api/v1/search/url?request=<web address>' --header 'x-api-key: <API token>'

Где:

Ответы

200 OK

Запрос обработан успешно.

Конечная точка возвращает объект JSON, содержащий результаты анализа указанного домена.

Параметры ответа 200 OK

Параметр

Тип

Описание

Zone

строка (string)

Цвет зоны, которой принадлежит веб-адрес. Доступные значения:

Red (красный) – веб-адрес содержит вредоносные объекты и может быть классифицирован как Опасный.

Orange (оранжевый) – веб-адрес может быть классифицирован как Недоверенный и содержать вредоносные объекты.

Yellow (желтый) – веб-адрес классифицируется как Рекламная или другая программа (рекламные программы, программы для взрослых или прочие программы).

Grey (серый) – для классификации веб-адреса нет или недостаточно информации.

Green (зеленый) – веб-адрес имеет статус Безопасный объект или Угрозы не обнаружены. Статус Угрозы не обнаружены присваивается веб-адресу, если он не классифицирован "Лабораторией Касперского", но ранее был проверен или проанализирован и на момент выполнения анализа угрозы не были обнаружены.

UrlGeneralInfo

объект (object)

Общая информация о запрашиваемом веб-адресе.

Url

строка (string)

Запрашиваемый веб-адрес.

Host

строка (string)

Имя домена верхнего уровня для запрашиваемого веб-адреса.

Ipv4Count

целое число (integer)

Количество IP-адресов (IPv4), относящихся к запрашиваемому веб-адресу.

FilesCount

целое число (integer)

Количество известных вредоносных файлов.

Categories

Массив строк (Array of strings)

Категории запрашиваемого веб-адреса. Если веб-адрес не относится ни к одной из заданных категорий, отображается Общая категория.

CategoriesWithZone

Массив объектов (Array of objects)

Категории запрашиваемого веб-адреса и зоны, к которым относятся эти категории:

Name – название категории.

Zone – цвет зоны категории, Красный или Желтый. Если веб-адрес не относится ни к одной из заданных категорий, отображается Общая категория.

UrlDomainWhoIs

объект (object)

Данные WHOIS для запрашиваемого веб-адреса.

DomainName

строка (string)

Имя домена для запрашиваемого веб-адреса.

Created

строка <дата-время> (string <date-time>)

Дата регистрации запрашиваемого веб-адреса.

Updated

строка <дата-время> (string <date-time>)

Дата последнего обновления регистрационных данных домена для запрашиваемого веб-адреса.

Expires

строка <дата-время> (string <date-time>)

Дата истечения предоплаченного срока действия для зарегистрированного домена.

NameServers

Массив строк (Array of strings)

Список серверов доменных имен для запрашиваемого веб-адреса.

Contacts

Массив строк (Array of strings)

Контактная информация владельца запрашиваемого веб-адреса.

Registrar

объект (object)

Информация о регистраторе домена:

Info – имя регистратора домена.

IanaId – идентификатор IANA регистратора домена.

DomainStatus

Массив строк (Array of strings)

Статусы домена для запрашиваемого веб-адреса.

RegistrationOrganization

строка (string)

Название регистрирующей организации.

400 Bad Request

Запрос не обработан: недопустимый запрос.

Убедитесь, что вы указали правильный параметр, и попытайтесь выполнить запрос еще раз.

401 Unauthorized

Запрос не обработан: не удалось выполнить аутентификацию пользователя.

Убедитесь, что вы указали правильные учетные данные, и попытайтесь выполнить запрос еще раз.

403 Forbidden

Запрос не обработан: превышены квота или лимит запросов.

Проверьте квоту и ограничения и попытайтесь выполнить запрос еще раз.

404 Not Found

Запрос не обработан: результаты анализа запрошенного объекта не найдены.

Убедитесь, что указан правильный объект, и выполните запрос еще раз.

414 URI Too Long

Запрос не обработан: длина веб-адреса превышает 2000 символов.

Длина веб-адреса ограничена 2000 символов. Веб-адреса, длина которых превышает 2000 символов, не могут быть запрошены с помощью RESTful API.

Укажите другой веб-адрес и запустите запрос.

В начало

[Topic URLLookupAPI]