Поиск веб-адресов
Развернуть все | Свернуть все
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
|
строка
|
Цвет зоны, которой принадлежит веб-адрес. Доступные значения:
Red (красный) – веб-адрес содержит вредоносные объекты и может быть классифицирован как Опасный объект.
Orange (оранжевый) – веб-адрес может быть классифицирован как Недоверенный и содержать вредоносные объекты.
Yellow (желтый) – веб-адрес классифицируется как Рекламные и другие программы (рекламные программы, программы для взрослых или прочие программы).
Grey(серый) – для классификации веб-адреса нет или недостаточно информации.
Green (зеленый) – веб-адрес имеет статус Безопасный объект или Угрозы не обнаружены. Статус Угрозы не обнаружены присваивается веб-адресу, если он не классифицирован "Лабораторией Касперского", но ранее был проверен или проанализирован и на момент выполнения анализа угрозы не были обнаружены.
|
UrlGeneralInfo
|
объект
|
Общая информация о запрошенном веб-адресе.
|
Url
|
строка
|
Запрашиваемый веб-адрес.
|
Host
|
строка
|
Имя домена верхнего уровня для запрашиваемого веб-адреса.
|
Ipv4Count
|
целое число
|
Количество IP-адресов (IPv4), относящихся к запрашиваемому веб-адресу.
|
FilesCount
|
целое число
|
Количество известных вредоносных файлов.
|
Categories
|
массив строк
|
Категории запрашиваемого веб-адреса. Если веб-адрес не относится ни к одной из заданных категорий, отображается Общая категория.
|
CategoriesWithZone
|
массив объектов
|
Категории запрашиваемого веб-адреса и зоны, к которым относятся эти категории:
Name – название категории.
Zone – цвет зоны категории, Красный или Желтый. Если веб-адрес не относится ни к одной из заданных категорий, отображается Общая категория.
|
UrlDomainWhoIs
|
объект
|
Информация WHOIS для запрошенного веб-адреса.
|
DomainName
|
строка
|
Имя домена для запрашиваемого веб-адреса.
|
Created
|
строка <дата-время>
|
Дата регистрации запрашиваемого веб-адреса.
|
Updated
|
строка <дата-время>
|
Дата последнего обновления регистрационных данных домена для запрашиваемого веб-адреса.
|
Expires
|
строка <дата-время>
|
Дата окончания предоплаченного срока действия для зарегистрированного домена.
|
NameServers
|
массив строк
|
Список серверов доменных имен для запрашиваемого веб-адреса.
|
Contacts
|
массив строк
|
Контактная информация владельца запрашиваемого веб-адреса.
|
Registrar
|
объект
|
Информация о регистраторе домена:
Info – имя регистратора домена.
IanaId – IANA ID регистратора домена.
|
DomainStatus
|
массив строк
|
Статусы домена для запрашиваемого веб-адреса.
|
RegistrationOrganization
|
строка
|
Имя регистрирующей организации.
|
400 Bad Request
Запрос не обработан: недопустимый запрос.
Убедитесь, что вы указали правильный параметр, и попытайтесь выполнить запрос еще раз.
401 Unauthorized
Запрос не обработан: не удалось выполнить аутентификацию пользователя.
Убедитесь, что вы указали правильные учетные данные, и попытайтесь выполнить запрос еще раз.
403 Forbidden
Запрос не обработан: превышены квота или лимит запросов.
Проверьте квоту и ограничения и попытайтесь выполнить запрос еще раз.
404 Not Found
Запрос не обработан: результаты анализа запрошенного объекта не найдены.
Убедитесь, что указан правильный объект, и выполните запрос еще раз.
414 URI Too Long
Запрос не обработан: длина веб-адреса превышает 2000 символов.
Длина веб-адреса ограничена 2000 символов. Веб-адреса, длина которых превышает 2000 символов, не могут быть запрошены с помощью RESTful API.
Укажите другой веб-адрес и запустите запрос.
В начало