Codificador IDNA

Corpos ACE vazios, Punycode truncado, caracteres ilegais, pontos consecutivos, esquemas, caminhos e violações de comprimento DNS falham com invalid_input que indica o índice do rótulo ofensor em vez de corromper a string em silêncio.

Codificar um hostname Unicode para ASCII IDNA (ToASCII / xn--)

Envie um corpo JSON com o campo de string obrigatório text definido para um nome de domínio internacionalizado completo —por exemplo uma marca de cidade com trema seguida de um segundo nível e um TLD clássicos— e deixe mode no padrão encode ou defina mode como encode explicitamente. A resposta inclui result (o hostname ASCII completo), ascii (a mesma forma de fio), unicode (a visão Unicode dobrada), label_count, has_ace true quando algum rótulo usou ACE, mode encode e method idna para que testes possam fixar cada campo.

Decodificar hostnames ACE de volta a Unicode e relatar rótulos inválidos

Defina mode como decode e coloque em text um hostname ASCII ou ACE misto como xn--mnchen-3ya.example.com. O motor percorre cada rótulo, remove o prefixo xn-- quando presente, valida que o corpo use apenas o alfabeto básico de letras, dígitos e hífens internos, e executa o decodificador RFC 3492 para recuperar pontos de código Unicode —incluindo caracteres do plano suplementar representados com pares substitutos em strings JavaScript. Rótulos ASCII puros não ACE passam no decode, e rótulos Unicode já presentes em um hostname misto são aceitos e rederivados para ASCII no campo ascii, de modo que a resposta sempre ofereça ambas as visões. Prefira esta capacidade quando a intenção de busca for um codificador ou decodificador de domínio IDNA para hostnames completos; experimentos de corpo Punycode de um único rótulo e resolução DNS ao vivo pertencem a outras ferramentas. Depois de decodificar um rótulo, recodifica e exige uma ida e volta exata contra o corpo, de modo que strings ACE truncadas ou editadas à mão falhem fechadas com invalid_input em vez de devolver glifos plausíveis mas errados. Corpos vazios após xn--, caracteres ilegais como pontuação, condições de overflow, rótulos vazios por pontos consecutivos e rótulos que excedem limites de comprimento DNS geram uma mensagem invalid_input descritiva que inclui a posição do rótulo em base um, para que ferramentas em lote possam destacar o segmento ruim. Um decode bem-sucedido devolve result e unicode como forma U-label legível, ascii como forma de fio, label_count, has_ace true quando houve ACE, mode decode e method idna. A validação falha não é cobrada na API pré-paga após a rejeição do motor, o que mantém barato o decode exploratório de linhas de log suspeitas e protege o saldo contra sucesso silencioso em lixo.

Uso da API, preços, fluxos DNS e limites práticos

Processe hostnames completos em uma única chamada —o design multi-rótulo é intencional para que SEO e produto batam com «codificador de domínio IDNA» em vez de forçar clientes a dividir e reunir rótulos. Não envie URLs completas: remova primeiro o esquema e o caminho, e converta apenas o hostname bare para o contrato permanecer estreito e as mensagens de erro acionáveis. Quando um rótulo falhar, corrija-o e reenvie; sucesso parcial nunca é devolvido, o que mantém o código do cliente simples e evita hostnames meio convertidos vazarem para o DNS de produção. Chame o codificador de domínios IDNA gratuito no navegador para playbooks de suporte, demos de sala de aula e verificações pontuais de hostname sem instalar truques de OpenSSL s_client nem runtimes de linguagem. Use a API pré-paga KIT quando um backend, painel de registrador, job de automação de certificado, gateway de e-mail ou SDK precisar do mesmo passo encode ou decode sob saldo a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após a rejeição do motor. Um fluxo típico codifica um hostname de marca Unicode antes de escrever A-labels em um template de zona ou lista server_name de proxy reverso, e depois decodifica nomes ACE copiados de cabeçalhos de e-mail, logs de transparência de certificados ou assuntos de tickets para que os operadores leiam as U-labels pretendidas. Autores de SDKs podem mapear o campo result para um botão de copiar, enquanto ascii, unicode, label_count e has_ace tornam exemplos OpenAPI autoexplicativos para quem aprende IDNA pela primeira vez.