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

Работа с API > Поиск веб-адресов

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

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

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>'

Где:

<web address> – веб-адрес, который требуется проанализировать.
<API token> – токен API, запрошенный в веб-интерфейсе.

Ответы

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)	Название регистрирующей организации.

Идентификатор статьи: URLLookupAPI, Последнее изменение: 6 февр. 2025 г.

В начало