Detector de versão IP

Uma entrada válida retorna a versão detectada e uma representação canônica estável, mais fácil de comparar, armazenar e revisar. Um texto inválido retorna um motivo específico, como octeto IPv4 fora do intervalo, zero inicial proibido, excesso de grupos IPv6 ou compressão incorreta com dois-pontos duplos. O analisador é determinístico, não consulta a rede e aplica regras estritas em vez de tentar adivinhar o significado de uma entrada incompleta ou acompanhada de outros elementos.

Identifique com precisão a sintaxe IPv4 e IPv6

IPv4 e IPv6 representam endereços em formatos textuais muito diferentes, e verificar apenas a presença de ponto ou dois-pontos não é suficiente para validar nenhum deles. Este detector analisa a string inteira conforme as regras estruturais das duas versões. IPv4 deve ter exatamente quatro octetos decimais separados por pontos. Cada octeto deve estar entre 0 e 255, conter somente dígitos e não começar com zero. IPv6 usa oito grupos hexadecimais separados por dois-pontos e pode abreviar uma sequência de grupos zero com dois-pontos duplos. Um endereço IPv6 também pode terminar com um endereço IPv4 decimal incorporado, desde que a contagem total de grupos permaneça correta. O resultado informa IPv4 ou IPv6 somente depois que o valor completo passa pela validação. Um valor que apenas se parece com um endereço é classificado como nenhum dos dois e recebe um motivo que identifica a regra violada. Assim, você pode usar o resultado em validação de formulários, revisão de configurações, limpeza de importações e testes automatizados sem correr o risco de aceitar dados incorretos por uma suposição flexível demais.

Use a saída canônica em comparações e armazenamento

Um endereço IP válido pode ter mais de uma grafia, sobretudo no IPv6. Letras hexadecimais maiúsculas e minúsculas representam os mesmos valores, zeros iniciais dentro de um grupo não alteram o endereço e uma sequência de grupos zero pode ser comprimida. O resultado IPv6 canônico usa letras minúsculas, remove zeros iniciais desnecessários e comprime a sequência mais longa de dois ou mais grupos zero. Se houver sequências de mesmo tamanho, a primeira é comprimida. Componentes IPv4 decimais incorporados são convertidos nos grupos hexadecimais equivalentes, para que a resposta sempre apresente uma única forma IPv6 consistente. IPv4 é retornado com quatro octetos decimais comuns. Essas regras permitem comparar strings canônicas sem considerar duas grafias do mesmo endereço como destinos diferentes. Elas também ajudam a preparar logs, remover duplicatas de configurações, criar snapshots de teste ou apresentar um endereço para revisão humana. A canonicalização não realiza DNS, geolocalização, análise de sub-rede nem teste de alcance; ela altera somente a representação, sem mudar o endereço numérico.

Entenda os motivos de rejeição e os limites estritos

Quando o texto do endereço é inválido, a resposta informa que ele não pertence a nenhuma versão e explica a rejeição. Falhas comuns de IPv4 incluem octeto ausente, componente acima de 255, caracteres não decimais ou zero inicial que softwares antigos podem interpretar de outra forma. Falhas comuns de IPv6 incluem grupo com mais de quatro dígitos hexadecimais, quantidade incorreta de grupos expandidos, mais de um par de dois-pontos duplos ou compressão que não substitui grupo algum. Colchetes usados em URLs, comprimentos de prefixo CIDR, números de porta e identificadores de zona ficam fora deste contrato de entrada. Remova esses elementos e envie apenas o endereço. Esse limite estrito mantém a validação previsível entre navegadores, servidores e linguagens cujos analisadores podem aceitar formas históricas diferentes. Um endereço ausente ou que não seja string é erro de contrato da solicitação; uma string com sintaxe inválida é um resultado normal, acompanhado do motivo. O algoritmo não usa estado externo nem rede, portanto solicitações repetidas sempre concordam. A API custa US$ 0,002 por solicitação, e a versão no navegador pode ser executada localmente.