Codificador IDNA

Cuerpos ACE vacíos, Punycode truncado, caracteres ilegales, puntos consecutivos, esquemas, rutas y violaciones de longitud DNS fallan con invalid_input que indica el índice de la etiqueta defectuosa en lugar de corromper la cadena en silencio.

Codificar un hostname Unicode a ASCII IDNA (ToASCII / xn--)

Envíe un cuerpo JSON con el campo de cadena obligatorio text fijado a un nombre de dominio internacionalizado completo —por ejemplo una marca de ciudad con diéresis seguida de un segundo nivel y un TLD clásicos— y deje mode en su valor predeterminado encode o fíjelo explícitamente a encode. La respuesta incluye result (el hostname ASCII completo), ascii (la misma forma de cable), unicode (la vista Unicode plegada), label_count, has_ace true si alguna etiqueta usó ACE, mode encode y method idna para que las pruebas puedan fijar cada campo.

Decodificar hostnames ACE a Unicode e informar etiquetas inválidas

Fije mode a decode y ponga en text un hostname ASCII o ACE mixto como xn--mnchen-3ya.example.com. El motor recorre cada etiqueta, quita el prefijo xn-- cuando existe, valida que el cuerpo use solo el alfabeto básico de letras, dígitos y guiones internos, y ejecuta el decodificador RFC 3492 para recuperar puntos de código Unicode —incluidos caracteres del plano suplementario representados con pares sustitutos en cadenas JavaScript—. Las etiquetas ASCII puras no ACE pasan en decode, y las etiquetas Unicode ya presentes en un hostname mixto se aceptan y se rederivan a ASCII en el campo ascii, de modo que la respuesta ofrece siempre ambas vistas. Prefiera esta capacidad cuando la intención de búsqueda sea un codificador o decodificador de dominios IDNA para hostnames completos; los experimentos de cuerpo Punycode de una sola etiqueta y la resolución DNS en vivo pertenecen a otras herramientas. Tras decodificar una etiqueta, la vuelve a codificar y exige un viaje de ida y vuelta exacto frente al cuerpo, de modo que cadenas ACE truncadas o editadas a mano fallen cerradas con invalid_input en lugar de devolver glifos plausibles pero incorrectos. Cuerpos vacíos tras xn--, caracteres ilegales como signos de puntuación, desbordamientos, etiquetas vacías por puntos consecutivos y etiquetas que superan los límites de longitud DNS generan un mensaje invalid_input descriptivo que incluye la posición de etiqueta en base uno, para que las herramientas masivas puedan resaltar el segmento defectuoso. Un decode correcto devuelve result y unicode como forma U-label legible, ascii como forma de cable, label_count, has_ace true si hubo alguna ACE, mode decode y method idna. La validación fallida no se cobra en la API prepago tras el rechazo del motor, lo que mantiene barato el decode exploratorio de líneas de log sospechosas y protege el saldo frente a éxitos silenciosos con basura.

Uso de la API, precios, flujos DNS y límites prácticos

Procese hostnames completos en una sola llamada: el diseño multi-etiqueta es intencional para que el SEO y el producto coincidan con «codificador de dominios IDNA» en lugar de obligar a los clientes a partir y reunir etiquetas. No envíe URL completas: quite primero el esquema y la ruta, y convierta solo el hostname bare para que el contrato siga estrecho y los mensajes de error sean accionables. Cuando falle una etiqueta, corríjala y reenvíe; nunca se devuelve éxito parcial, lo que mantiene simple el código del cliente y evita que hostnames a medio convertir se filtren al DNS de producción. Utilice el codificador de dominios IDNA gratuito en el navegador para guías de soporte, demos de aula y comprobaciones puntuales de hostname sin instalar trucos de OpenSSL s_client ni runtimes de lenguaje. Use la API prepago de KIT cuando un backend, panel de registrador, trabajo de automatización de certificados, puerta de correo o SDK necesite el mismo paso encode o decode con saldo a $0.002 por ítem correcto; los fallos de validación nunca consumen saldo tras el rechazo del motor. Un flujo típico codifica un hostname de marca Unicode antes de escribir A-labels en una plantilla de zona o lista server_name de proxy inverso, y luego decodifica nombres ACE copiados de cabeceras de correo, registros de transparencia de certificados o asuntos de tickets para que los operadores lean las U-labels previstas. Los autores de SDK pueden mapear el campo result a un botón de copiar, mientras ascii, unicode, label_count y has_ace hacen autoexplicativos los ejemplos OpenAPI para quien aprende IDNA por primera vez.