📘 Описание API: IP-API

🌐 Информация об IP (query)

📡 Сетевые данные

Поле	Тип	Описание
asn	string	Автономная система
range	string	Диапазон IP
hostName	string	Имя хоста
provider	string	Интернет-провайдер
org	string	Организация

🕵️ Анонимность (anonymity)

Поле	Тип	Описание
proxy	string	Используется ли VPN/прокси
type	string	Тип (например, VPN (см. полное описание "Справка: типы адресов, VPN прокси")

⚠️ Риск (risk)

Поле	Тип	Описание
value	integer	Уровень риска (0–100) (см. полное описание "Справка: Оценка риска")

🌍 Геолокация (location)

Поле	Тип	Описание
continent	string	Континент
continentCode	string	Код континента
country	string	Страна
isoCode	string	ISO-код страны
region	string	Регион
regionCode	string	Код региона
city	string	Город
postCode	string	Почтовый индекс
timezone	string	Временная зона
lat	string	Широта
lon	string	Долгота

💰 Валюта (currency)

Поле	Тип	Описание
code	string	Код валюты
name	string	Название
symbol	string	Символ

🏳️ Флаги (assets)

waving: Флаги разных размеров (16x12 до 256x192)

sameWidth: Варианты одной ширины (w20, w40, w80...)

sameHeight: Варианты одной высоты (h20, h24, h40...)

🖥️ Информация о соединении (userConnectionInfo)

Поле	Тип	Описание
userAgent	string	Строка браузера клиента

🔐 Отпечаток запроса (imprint)

Поле	Тип	Описание
endpointUrl	string	URL для запроса отпечатка
X-IMPRINT	string	Уникальный токен отпечатка
description_ru	string	Всегда: С результата этого запроса был сделан отпечаток. Посмотреть полное содержание в любое время можно через отправку запроса на endpointUrl с содержанием заголовка X-IMPRINT.

📒 Справка: типы адресов и прокси

Тип	Описание
Residential	IP-адрес предположительно принадлежит резиденту (домашний интернет).
Wireless	IP-адрес предположительно используется с мобильного устройства или беспроводного модема.
Business	IP-адрес используется бизнесом или организацией.
Hosting	IP принадлежит хостинг-провайдеру или дата-центру.
TOR	IP обнаружен как TOR exit-node.
Scraper	IP использовался для веб-скрапинга (бот).
SOCKS	Работает как прокси-сервер SOCKS различного типа.
SOCKS4	SOCKS4 прокси-сервер.
SOCKS4A	SOCKS4 с разрешением хостнейма.
SOCKS5	SOCKS5 прокси-сервер.
SOCKS5H	SOCKS5 с разрешением хостнейма (SOCKS5H).
Shadowsocks	Работает как Shadowsocks прокси.
HTTP	HTTP-прокси.
HTTPS	HTTPS-прокси.
Compromised Server	Сервер скомпрометирован и может использоваться для атак (спам, автоматические регистрации и т. д.).
Inference Engine	Система предполагает, что IP является прокси, но не может точно определить тип.
OpenVPN	Публичный OpenVPN-сервер (используется как бесплатный прокси).
VPN	Виртуальная частная сеть (может быть дата-центр или платный VPN).

📊 Справка: Оценка риска

Оценка	Определение
66%	Прокси, но без дополнительной информации
100%	Прокси с известным протоколом и портом
66%	Скомпрометированный сервер без других данных
66%	Хостинг-провайдер, подозреваемый как источник VPN
73%	VPN-сервер, принадлежащий известному VPN-сервису

📦 Пример JSON-ответа

{
  "status": "ok",
  "213.134.220.49": {
    "asn": "AS25227",
    "range": "213.134.220.49/26",
    "hostName": "49.220.unused-addr.ncport.ru",
    "provider": "JSC Avantel",
    "org": "JSC NewCom Port",
    "anonymity": {
      "proxy": "no",
      "type": "Business"
    },
    "risk": {
      "value": "unknown"
    },
    "location": {
      "continent": "Europe",
      "continentCode": "EU",
      "country": "Russia",
      "isoCode": "RU",
      "region": "Krasnodarskiy",
      "regionCode": "KDA",
      "timezone": "Asia/Krasnoyarsk",
      "city": "Tuapse",
      "postCode": "",
      "lat": "44.0943",
      "lon": "39.0628",
      "currency": {
        "code": "RUB",
        "name": "Ruble",
        "symbol": "RUB"
      },
      "assets": {
        "flags": {
          "waving": {
            "0": "https://prod.ip-api.ru/assets/flags/16x12/RU.png",
            "...": "..."
          },
          "original": {
            "sameWidth": {
              "0": "https://prod.ip-api.ru/assets/flags/w20/RU.png",
              "...": "..."
            },
            "sameHeight": {
              "0": "https://prod.ip-api.ru/assets/flags/h20/RU.png",
              "...": "..."
            }
          }
        }
      }
    },
    "userConnectionInfo": {
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:136.0) Gecko/20100101 Firefox/136.0"
    }
  },
  "imprint": {
    "endpointUrl": "https://prod.ip-api.ru/checkIP/imprint/",
    "X-IMPRINT": "[длинный зашифрованный токен]",
    "description_ru": "С результата этого запроса был сделан отпечаток..."
  }
}

⚠️ Для читаемости некоторые поля, такие как ссылки на флаги и длинные ключи отпечатков, были сокращены.