Codificação e decodificação de URL: qual é a diferença?

A codificação de URL converte caracteres inseguros ou significativos em um componente de URL em sequências percentuais de três caracteres; a decodificação de URL converte sequências válidas de volta em caracteres legíveis. Codifique antes de inserir dados brutos em um componente. Decodifique quando precisar inspecionar ou usar um valor já codificado. O Codificador de URL do ClockTools e o Decodificador de URL permitem testar ambas as direções sem alterar o texto original.

Escolha a operação conforme a entrada

Se a entrada for dados legíveis por humanos, como summer shoes & bags, codifique-os antes de colocá-los em um valor de consulta. Se a entrada já contém sequências como %20 e você precisa dos caracteres originais, decodifique-a uma vez. O Padrão de URL WHATWG define conjuntos de codificação percentual para análise e serialização de URL; RFC 3986 explica a forma das sequências percentuais de três caracteres e os caracteres reservados.

Codificação não é criptografia. Torna a sintaxe inequívoca; não esconde informações confidenciais.

Siga um exemplo reversível

Comece com summer shoes & bags. A codificação de componentes produz summer%20shoes%20%26%20bags. Os espaços tornam-se %20 e o e comercial torna-se %26, para ser tratado como dado, não como separador. Decodificar esse resultado uma única vez restaura a frase original.

Na verificação ao vivo do ClockTools, uma amostra de 74 caracteres passou a ter 102 caracteres com 14 sequências de escape no modo URI Component. Essas contagens descrevem apenas aquela amostra; entradas diferentes produzem totais diferentes.

Respeite os limites dos componentes de URL

Uma URL contém partes com sintaxe diferente: esquema, host, caminho, consulta e fragmento. O fluxo de trabalho mais seguro é analisar a URL, alterar o valor pretendido e serializá-la usando a API do seu ambiente. Codificar uma URL completa já montada pode transformar em sequências de escape separadores como :, /, ? e & que deveriam manter seu significado estrutural.

O caso do caractere de espaço merece atenção especial. A codificação percentual genérica representa um espaço como %20. A serialização de consulta no estilo de formulário HTML pode usar +. Leia Codificação de URL para um espaço para esse problema restrito de interoperabilidade; este artigo aborda direção de operação, escolha de componentes e reversão.

Evite a codificação dupla

A codificação dupla acontece quando o texto codificado é passado novamente por um codificador. Por exemplo, %20 pode se tornar %2520 porque % é codificado como %25. Controle se cada valor é bruto ou codificado, faça a codificação em um único ponto de passagem e decodifique apenas quantas vezes o contrato de dados exigir. A RFC 3986 alerta que as strings com codificação percentual não devem ser codificadas ou decodificadas mais de uma vez sem um motivo claro.

Ao depurar, copie o menor componente para a ferramenta, decodifique uma vez e compare o resultado com o valor bruto esperado. Nunca cole segredos, tokens ou URLs privadas em uma ferramenta na qual você não confia.