POST AI agent ready /v1/ip/in-range

API de verificação de intervalo IP CIDR - Correspondência de sub-rede gratuita

Verifica se um endereço IPv4 está dentro de um determinado intervalo CIDR. Retorna endereço de rede, endereço de broadcast, comprimento do prefixo e total de hosts no intervalo.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/ip/in-range \
  -H "Content-Type: application/json" \
  -d '{"ip":"192.168.1.50","range":"192.168.1.0/24"}'

When to use this API

Listar IPs de escritórios corporativos na lista de permissões

Antes de conceder acesso a um painel de administração interno, verifique se o IP da solicitação recebida se enquadra no bloco CIDR VPN da sua empresa. Rejeite solicitações de IPs fora do intervalo e registre a tentativa para análise de segurança.

Classifique o tráfego por origem da rede

Identifique as solicitações recebidas como "provedor de nuvem", "residencial" ou "corporativo" verificando cada IP em relação aos blocos CIDR conhecidos para AWS, GCP e Azure. Use a classificação para aplicar diferentes limites de taxa ou regras de detecção de bots.

Frequently asked questions

Quais formatos de notação CIDR são suportados?

Notação CIDR IPv4 padrão como 10.0.0.0/8, 172.16.0.0/12 ou 192.168.1.0/24. O comprimento do prefixo deve estar entre 0 e 32.

Isso suporta intervalos CIDR IPv6?

Atualmente, esse endpoint oferece suporte apenas a endereços IPv4 e intervalos CIDR. O suporte IPv6 está planejado para uma versão futura.

O que total_hosts representa?

total_hosts é o número total de endereços no bloco CIDR, incluindo os endereços de rede e de transmissão. Para um intervalo /24, total_hosts é 256 (2^8).

Posso verificar vários IPs em um intervalo em uma única chamada?

Este endpoint verifica um IP por vez. Para verificações em massa, envie várias solicitações paralelas ou faça um loop pela lista de IPs do lado do cliente.

Get your API key

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