Codificador de URL

O Codificador de URL é uma ferramenta gratuita que converte uma string na representação codificada usada em parâmetros de consulta de URLs e em outros dados web baseados em texto.

O que é codificação de URL e para que ela serve?

A codificação de URL substitui caracteres que têm significado especial em uma URL por um sinal de porcentagem seguido de dígitos hexadecimais. Assim, o texto pode passar por sistemas que aceitam apenas um conjunto restrito de caracteres.

Por exemplo, o "e" comercial separa parâmetros de consulta. Portanto, quando faz parte de um valor, ele precisa ser codificado como %26. Os espaços também exigem tratamento especial. Esta ferramenta usa a função urlencode do PHP, que converte espaços em sinais de mais.

Antes: tea and cake

Depois: tea+and+cake

É possível encontrar texto codificado para URL em:

• strings de consulta enviadas por formulários web;
• URIs de dados com texto que não pode aparecer literalmente;
• links incluídos em mensagens de e-mail;
• valores de URL armazenados em cargas JSON;
• parâmetros de redirecionamento e callback usados por aplicações web;
• URLs associadas a domínios internacionalizados, embora o nome de domínio em si possa exigir Punycode em vez de codificação por porcentagem.

Codificação de URL não é criptografia e não oferece sigilo. Qualquer pessoa que consiga ver um valor de URL codificado por porcentagem pode decodificá-lo.

Como usar o Codificador de URL?

Digite a string que precisa ser codificada, execute a ferramenta e veja o valor convertido no campo de resultado URL codificada. Codifique apenas o valor, sem incluir aspas ao redor dele nem textos explicativos.

O processamento ocorre no servidor. Sua entrada é enviada ao servidor por HTTPS e não é armazenada. Ainda assim, evite colocar senhas, tokens de sessão ou dados pessoais privados em URLs, pois endereços web podem aparecer no histórico do navegador, em sistemas de análise e nos logs do servidor.

Para reverter a operação, use o Decodificador de URL. Se as mesmas regras de codificação de caracteres e de formulários forem usadas nos dois sentidos, o valor decodificado corretamente deverá corresponder ao texto original.

Devo codificar a URL inteira ou apenas o valor do parâmetro?

Normalmente, codifique cada valor de parâmetro, não a URL completa. Codificar o endereço inteiro também substituiria caracteres estruturais, como dois-pontos, barras, ponto de interrogação e sinal de igual.

Considere o valor de pesquisa green tea & coffee. Sua forma codificada é green+tea+%26+coffee, que pode ser inserida depois do nome de um parâmetro. Codificar o endereço completo ocultaria os separadores de que o navegador precisa para identificar o esquema, o host, o caminho e a string de consulta.

O uso de urlencode nesta ferramenta é adequado para parâmetros de consulta no estilo de formulários HTML. Algumas APIs e segmentos de caminho seguem as convenções da RFC 3986, nas quais um espaço é representado como %20, e não como +. Verifique se o sistema de destino espera codificação de formulário com + ou %20 no estilo da RFC 3986.

Exemplos práticos de codificação de URL

Letras e números ASCII continuam legíveis. Espaços viram sinais de mais, enquanto sinais de pontuação reservados e textos não ASCII são representados por bytes codificados.

• hello world se torna hello+world.
• tea & cake se torna tea+%26+cake.
• email=test@example.com se torna email%3Dtest%40example.com.
• 100% ready se torna 100%25+ready.
• café se torna caf%C3%A9 quando o texto de origem usa UTF-8.

Letras acentuadas e sistemas de escrita não latinos são primeiro representados como bytes por uma codificação de caracteres, geralmente UTF-8 na web. Depois, cada byte fora do conjunto permitido recebe sua própria sequência de escape com porcentagem. Por isso, um único caractere visível pode gerar vários grupos iniciados por %.

Números não exigem tratamento especial. Uma entrada vazia não produz conteúdo codificado. Entradas muito longas podem aumentar consideravelmente, pois cada byte codificado ocupa três caracteres.

Por que a decodificação de URL falha ou gera texto ilegível?

A decodificação geralmente falha porque a entrada foi codificada com regras diferentes, foi codificada mais de uma vez ou não representa texto no conjunto de caracteres esperado.

• Tratamento diferente de espaços. Um decodificador de formulários interpreta + como espaço, enquanto um decodificador estrito de porcentagem pode mantê-lo como sinal de mais.
• Codificação dupla. O sinal de porcentagem em %26 também pode ser convertido em %25, gerando %2526. Nesse caso, uma única decodificação retorna %26, e não o "e" comercial original.
• Codificação de caracteres incorreta. Bytes UTF-8 decodificados como outro conjunto de caracteres podem gerar símbolos de substituição ou letras ilegíveis.
• Dados binários em vez de texto. Os bytes decodificados podem corresponder a uma imagem, um arquivo compactado ou outro tipo de arquivo. Exibi-los como texto gera conteúdo ilegível.
• Formato ou alfabeto incorreto. Base64 seguro para URLs, Base64 padrão e codificação por porcentagem são formatos diferentes. Aplicar um decodificador de URL a um texto Base64 não recuperará o valor pretendido.

A codificação de URL não usa caracteres de preenchimento. Se um decodificador informar que está faltando preenchimento, a entrada provavelmente está em Base64 ou em outro formato com preenchimento, e não em texto codificado por porcentagem.

Perguntas frequentes

Faz diferença usar letras maiúsculas ou minúsculas nas sequências com porcentagem?

Não. As letras hexadecimais nas sequências de escape com porcentagem não diferenciam maiúsculas de minúsculas. Portanto, %2F e %2f representam uma barra. Recomenda-se usar dígitos hexadecimais em maiúsculas para manter uma representação consistente.

A codificação de URL converte nomes de domínio internacionais?

Não. Rótulos de domínio, como um nome que contenha é, normalmente exigem o processamento de Nomes de Domínio Internacionalizados e uma forma Punycode em ASCII que comece com xn--. A codificação por porcentagem é usada em outros componentes da URL e não deve ser tratada como substituta dessa conversão.

O que acontece com quebras de linha e tabulações?

Os bytes de tabulações e quebras de linha são codificados por porcentagem porque não podem aparecer literalmente em um valor de URL convencional. Uma tabulação costuma ser representada como %09, enquanto o formato das terminações de linha depende de a origem usar caracteres LF ou CRLF.

Por que uma URL codificada ainda falha quando é colada em uma aplicação?

A aplicação pode esperar um valor bruto e fazer sua própria codificação, causando codificação dupla. Ela também pode rejeitar a URL por causa de um limite de comprimento total ou porque um caractere reservado foi codificado em uma parte estrutural do endereço. Antes de codificar, verifique qual componente específico a aplicação solicita.

É seguro compartilhar dados codificados em uma string de consulta?

Não. A codificação de URL por porcentagem apenas altera a representação, e navegadores e ferramentas para desenvolvedores podem revelar o valor original. Antes de compartilhar um link, verifique se os parâmetros de consulta contêm endereços de e-mail, referências de contas, tokens de acesso ou outros dados que não devam ser divulgados.