Поиск IP-адреса

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

Поиск IP-адреса

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

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

Запрос

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

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

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

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

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

Где:

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

Ответы

200 OK

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

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

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

Параметр	Тип	Описание
`Zone`	строка (string)	Цвет зоны, которой принадлежит IP-адрес. Доступные значения: `Red` (красный) – IP-адрес содержит вредоносные объекты и может быть классифицирован как Опасный. `Orange` (оранжевый) – IP-адрес может быть классифицирован как Недоверенный и содержать вредоносные объекты. `Yellow` (желтый) – IP-адрес классифицируется как Рекламная или другая программа (рекламные программы, программы для взрослых или прочие программы). `Grey` (серый) – для классификации IP-адреса нет или недостаточно информации. `Green` (зеленый) – IP-адрес имеет статус Безопасный объект или Угрозы не обнаружены. Статус Угрозы не обнаружены присваивается IP-адресу, если он не классифицирован "Лабораторией Касперского", но ранее был проверен или проанализирован и на момент выполнения анализа угрозы не были обнаружены.
`IpGeneralInfo`	объект (object)	Общая информация о запрашиваемом IP-адресе.
`Status`	строка (string)	Статус IP-адреса (`known`, если страна определена, `reserved` для зарезервированных IP-адресов специального назначения (см. RFC 6890) и `NoInfo` для IP-адресов, не принадлежащих ни одной стране и не зарезервированных).
`CountryCode`	строка (string)	Двухбуквенный код страны (стандарт ISO 3166-1 alpha-2), которой принадлежит IP-адрес.
`HitsCount`	целое число (integer)	Количество обращений, связанных с запрашиваемым IP-адресом (популярность).
`FirstSeen`	строка <дата-время> (string <date-time>)	Дата и время, когда запрашиваемый IP-адрес впервые появился в статистических данных экспертных систем "Лаборатории Касперского".
`Ip`	строка (string)	Запрашиваемый IP-адрес.
`Categories`	Массив строк (Array of strings)	Категория запрашиваемого IP-адреса.
`CategoriesWithZone`	Массив объектов (Array of objects)	Категории запрашиваемого IP-адреса и зоны, к которым относятся эти категории: `Name` – название категории. `Zone` – цвет зоны категории, Красный или Желтый.
`IpWhoIs`	объект (object)	Данные WHOIS для запрашиваемого IP-адреса.
`Asn`	Массив объектов (Array of objects)	Номер автономной системы: `Number` – номер автономной системы в соответствии со стандартами RFC 1771 и RFC 4893. `Description` – описание автономной системы.
`Net`	объект (object)	Информация о сети, к которой принадлежит запрашиваемый IP-адрес: `RangeStart` – начальный IP-адрес сети, которой принадлежит запрашиваемый IP-адрес. `RangeEnd` – конечный IP-адрес сети, которой принадлежит запрашиваемый IP-адрес. `Created` – дата регистрации IP-адреса. `Changed` – дата последнего обновления информации об IP-адресе. `Name` – название сети, которой принадлежит IP-адрес. `Description` – описание сети, которой принадлежит IP-адрес.

400 Bad Request

401 Unauthorized

403 Forbidden

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

В начало