POST AI agent ready /v1/ip/intelligence

IP Intelligence API — расширенное профилирование IP с использованием географических, сетевых и TLS-данных

Возвращает подробный профиль IP-адреса вызывающего абонента, включая геолокацию (страна, город, регион, координаты, членство в ЕС), сетевые данные (ASN, организация, обратный DNS), индикаторы безопасности (обнаружение VPN с сигналами доверия), сведения о соединении TLS (версия, шифр, протокол) и метаданные соединения Cloudflare.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/ip/intelligence \
  -H "Content-Type: application/json" \
  -d '{}'

When to use this API

Регистрация доступа с нулевым доверием

Регистрируйте полный профиль IP при каждом событии аутентификации. Собирайте данные о географическом положении, ASN, версии TLS и статусе VPN, чтобы построить базовый уровень поведения для каждого пользователя. Отмечайте входы, отклоняющиеся от установленного шаблона.

Расширение возможностей обнаружения ботов

Объедините данные отпечатков пальцев TLS и индикаторы VPN с существующим конвейером обнаружения ботов. Легальные браузеры и безголовые парсеры создают разные наборы шифров TLS и версии протокола.

Снятие отпечатков пальцев соединения

Используйте версию TLS, шифр, протокол HTTP и время приема-передачи TCP для создания отпечатка соединения. Отслеживайте согласованность отпечатков пальцев между сеансами для обнаружения мошенничества, не полагаясь на файлы cookie.

Frequently asked questions

Могу ли я передать в профиль определенный IP-адрес?

Нет. Эта конечная точка профилирует собственное соединение вызывающего абонента. Данные IP, TLS и соединения поступают непосредственно с периферии Cloudflare, обрабатывающей ваш запрос. Для поиска произвольных IP-адресов используйте конечную точку /v1/ip/lookup.

Насколько надежно обнаружение VPN?

При обнаружении VPN используются эвристики, такие как известные диапазоны VPN ASN и IP-блоки центров обработки данных. Он перехватывает основных провайдеров VPN, но не может обнаружить все VPN-соединения. Массив vpn_indicators объясняет, какие сигналы активировали этот флаг.

Какие данные TLS доступны?

Раздел TLS включает согласованную версию TLS (TLSv1.2 или TLSv1.3), набор шифров и протокол HTTP (h2, h3 или http/1.1). Эти данные поступают с периферии Cloudflare и отражают фактические параметры соединения.

Учитывается ли эта конечная точка в рамках моего ограничения скорости?

Да. Он считается одним вызовом API, как и любая другая конечная точка. На анонимных пользователей распространяется стандартный пакетный лимит в 5 запросов в минуту и лимит в 100 запросов в день.

Данные геолокации совпадают с /v1/ip/lookup?

Геополя идентичны по формату. Разница в том, что /v1/ip/intelligence добавляет разделы сети, безопасности, TLS и подключения, которых нет в /v1/ip/lookup.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.