Pular para o conteúdo
POST AI agent ready /v1/ip/intelligence

API IP Intelligence - Perfil IP rico com dados geográficos, de rede e TLS

Retorna um perfil abrangente para o endereço IP do chamador, incluindo geolocalização (país, cidade, região, coordenadas, adesão à UE), dados de rede (ASN, organização, DNS reverso), indicadores de segurança (detecção de VPN com sinais de confiança), detalhes de conexão TLS (versão, cifra, protocolo) e metadados de conexão Cloudflare.

Code examples

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

When to use this API

Registro de acesso de confiança zero

Registre o perfil IP completo em cada evento de autenticação. Capture status geográfico, ASN, versão TLS e VPN para criar uma linha de base comportamental para cada usuário. Sinalize logins que se desviem do padrão estabelecido.

Enriquecimento de detecção de bot

Combine dados de impressão digital TLS e indicadores VPN com seu pipeline de detecção de bot existente. Navegadores legítimos e raspadores sem cabeça produzem diferentes conjuntos de criptografia TLS e versões de protocolo.

Impressão digital de conexão

Use a versão TLS, a cifra, o protocolo HTTP e o tempo de ida e volta TCP para criar uma impressão digital de conexão. Rastreie a consistência das impressões digitais entre sessões para detecção de fraudes sem depender de cookies.

Frequently asked questions

Posso passar um endereço IP específico para o perfil?
Não. Este endpoint cria o perfil da própria conexão do chamador. Os dados de IP, TLS e conexão vêm diretamente da borda da Cloudflare que atende sua solicitação. Para procurar IPs arbitrários, use o endpoint /v1/ip/lookup.
Quão confiável é a detecção de VPN?
A detecção de VPN usa heurísticas como intervalos VPN ASN conhecidos e blocos de IP de datacenter. Ele captura os principais provedores de VPN, mas não consegue detectar todas as conexões VPN. A matriz vpn_indicators explica quais sinais acionaram o sinalizador.
Quais dados TLS estão disponíveis?
A seção TLS inclui a versão negociada do TLS (TLSv1.2 ou TLSv1.3), o conjunto de criptografia e o protocolo HTTP (h2, h3 ou http/1.1). Esses dados vêm da borda da Cloudflare e refletem os parâmetros reais da conexão.
Este endpoint conta no meu limite de taxa?
Sim. Conta como uma chamada de API como qualquer outro endpoint. Os usuários anônimos estão sujeitos ao limite padrão de 5 req/min e 100 req/dia.
Os dados de geolocalização são iguais a /v1/ip/lookup?
Os campos geográficos são idênticos em formato. A diferença é que /v1/ip/intelligence adiciona seções de rede, segurança, TLS e conexão que /v1/ip/lookup não inclui.

Get your API key

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

Sign up free View full docs