Detector de versión IP

Una entrada válida devuelve la versión detectada y una representación canónica estable, más fácil de comparar, guardar y revisar. Si el texto no es válido, devuelve un motivo concreto, como un octeto IPv4 fuera de rango, un cero inicial ilegal, demasiados grupos IPv6 o una compresión de dos puntos incorrecta. El analizador es determinista, no consulta la red y aplica reglas estrictas en vez de adivinar qué pretendía expresar una entrada incompleta o decorada.

Identifique con precisión la sintaxis IPv4 e IPv6

IPv4 e IPv6 representan las direcciones con formatos textuales muy distintos, y comprobar solo si existe un punto o dos puntos no basta para validar ninguna de ellas. Este detector analiza la cadena completa según las reglas estructurales de ambas versiones. IPv4 debe tener exactamente cuatro octetos decimales separados por puntos. Cada octeto debe estar entre 0 y 255, contener únicamente dígitos y no comenzar con cero. IPv6 utiliza ocho grupos hexadecimales separados por dos puntos y permite abreviar una secuencia de grupos cero mediante dos puntos dobles. Una dirección IPv6 también puede terminar en una dirección IPv4 decimal incrustada si el número total de grupos sigue siendo correcto. El resultado indica IPv4 o IPv6 solo cuando el valor completo supera la validación. Un valor que únicamente parece una dirección se clasifica como ninguna y aporta el motivo de la regla incumplida. Así puede usar el resultado en formularios, revisiones de configuración, limpieza de importaciones y pruebas automatizadas sin aceptar datos erróneos por una suposición demasiado flexible.

Utilice la salida canónica para comparar y almacenar

Una dirección IP válida puede escribirse de varias formas, especialmente si es IPv6. Las letras hexadecimales en mayúsculas o minúsculas representan los mismos valores, los ceros iniciales de un grupo no cambian la dirección y una secuencia de grupos cero puede comprimirse. El resultado IPv6 canónico usa hexadecimales en minúscula, elimina los ceros iniciales innecesarios y comprime la secuencia más larga de dos o más grupos cero. Si hay varias secuencias de igual longitud, comprime la primera. Los componentes IPv4 decimales incrustados se convierten en sus grupos hexadecimales equivalentes, de modo que la respuesta siempre tenga un único formato IPv6 estable. IPv4 se devuelve como cuatro octetos decimales normales. Estas reglas permiten comparar cadenas canónicas sin confundir dos escrituras de una misma dirección con dos extremos distintos. También ayudan a preparar registros, eliminar duplicados de configuración, crear instantáneas de prueba o mostrar una dirección para revisión. La canonicalización no realiza DNS, geolocalización, análisis de subredes ni pruebas de alcance; solo cambia la representación, no el valor numérico.

Interprete los motivos de rechazo y los límites estrictos

Cuando el texto no es válido, la respuesta indica que no pertenece a ninguna versión y explica el rechazo. Entre los fallos IPv4 habituales están un octeto ausente, un componente superior a 255, caracteres no decimales o un cero inicial que programas antiguos podrían interpretar de otra manera. En IPv6 son comunes un grupo con más de cuatro dígitos hexadecimales, un número incorrecto de grupos expandidos, más de un doble dos puntos o una compresión que no sustituye ningún grupo. Los corchetes propios de una URL, las longitudes de prefijo CIDR, los puertos y los identificadores de zona quedan fuera del contrato de entrada. Elimine esos adornos y envíe solo la dirección. Este límite estricto mantiene una validación predecible entre navegadores, servidores y lenguajes cuyos analizadores auxiliares pueden aceptar formatos históricos distintos. Una dirección ausente o que no sea cadena es un error de contrato; una cadena con sintaxis incorrecta es un resultado normal con motivo de rechazo. El algoritmo no usa red ni estado externo, por lo que siempre ofrece la misma respuesta. Cada solicitud API cuesta $0.002 y la versión del navegador puede ejecutarse localmente.