Проверки IP¶

Общие правила чтения полей, причины отказа и форматы файлов full/light описаны в обзоре.

Родитель: ip_check_results[]. Все сохранённые результаты проверки IP сессии. Количество элементов не является количеством попыток пользователя: возможны несколько адресов и результатов обработки.

Поля элемента ip_check_results[].

Поля с пометкой «Обязателен» присутствуют всегда внутри этого объекта. Остальные поля — при наличии значения; null исключается из ответа.

Поле	Тип в JSON	Назначение и условия
`result`	boolean	Обязателен. Принятие проверки по настройкам. Может быть `true` при разрешённой ошибке поставщика; не гарантия получения всех сетевых данных.
`verdict`	string, enum	Обязателен: `ok` — принят; `suspicious` — подозрительный / нет достаточных данных при отказе; `blocked` — заблокирован по найденным данным. При дополнительных проверках страны `result` может стать `false` без изменения `verdict`; учитывайте оба поля.
`ip`	string	Проверенный IPv4/IPv6-адрес.
`network_asn`	string	Номер автономной системы в формате источника.
`network_range`	string	Диапазон сети в формате источника.
`network_provider`	string	Провайдер сети.
`network_organisation`	string	Организация-владелец сети.
`network_type`	string, enum	`residential` — домашняя сеть; `business` — корпоративная; `wireless` — беспроводная; `hosting` — хостинг; `unknown` — неизвестно.
`continent_name`	string	Название континента по IP.
`continent_code`	string	Код континента по IP.
`country_name`	string	Название страны по IP.
`country_code`	string	Код страны по IP.
`city_name`	string	Название города по IP.
`device_estimate_address`	integer	Оценочное количество устройств на IP-адресе, неотрицательное число; при наличии оценки источника.
`device_estimate_subnet`	integer	Оценочное количество устройств в подсети, неотрицательное число.
`is_proxy`	boolean	Признак прокси.
`is_vpn`	boolean	Признак VPN.
`is_tor`	boolean	Признак Tor.
`is_hosting`	boolean	Признак хостинга / дата-центра.
`is_compromised`	boolean	Признак компрометации по классификации источника.
`is_scraper`	boolean	Признак автоматического сбора данных по классификации источника.
`is_anonymous`	boolean	Признак анонимизации по классификации источника.
`risk_score`	integer	Оценка риска; сравнивается с настроенным порогом. При некоторых разрешённых ошибках сохраняется `0`. Универсальная шкала и верхняя граница этим API не установлены.
`confidence`	integer	Уверенность оценки поставщика; единицы и верхняя граница не закреплены.
`failure_reason`	object	Причина отказа, если записана; структура.

Отказ зависит, в частности, от настроек отклонения VPN/прокси, дата-центров, порога риска, несовпадения страны и поведения при ошибках. false у сетевого признака и отсутствие этого признака различаются.

JSON-примеры¶

Фрагменты корневого объекта ответа, а не целостные ответы. Все значения и ссылки условные. Формат файлов соответствует пояснениям на этой странице.

{
  "ip_check_results": [
    {
      "ip": "192.0.2.10",
      "result": true,
      "verdict": "ok",
      "is_proxy": false,
      "is_vpn": false,
      "is_tor": false,
      "risk_score": 0
    }
  ]
}