Codificar e decodificar URL

Escolha codificar quando o conteúdo precisar circular com segurança como componente de URL, ou decodificar para interpretar escapes em logs, redirecionamentos, consultas e links copiados. A operação é determinística, não mantém estado e rejeita sequências malformadas em vez de gerar uma saída enganosa. Você pode executá-la no navegador ou usar o mesmo comportamento pela API por US$ 0,002 por item.

Quando usar a codificação percentual

As URLs reservam caracteres para sua estrutura: barras separam segmentos, pontos de interrogação iniciam consultas, os símbolos de E comercial separam parâmetros, sinais de igual dividem nomes e valores, e cerquilhas introduzem fragmentos. Quando um desses caracteres faz parte do dado, ele não pode ser confundido com a estrutura. A codificação converte a entrada em UTF-8 e representa cada byte que não seja um caractere não reservado da RFC 3986 por um sinal de porcentagem e dois dígitos hexadecimais. Letras, números, hífens, pontos, sublinhados e tis permanecem legíveis. Espaços viram <code>%20</code>, não um sinal de adição, e a pontuação reservada é escapada porque a entrada é tratada como um valor, não como uma URL completa. Codifique apenas o componente que você vai inserir; codificar uma URL já montada também alteraria seus delimitadores estruturais.

Como a decodificação rigorosa protege os dados

A decodificação verifica toda a entrada antes de devolver um valor. Cada sinal de porcentagem deve ser seguido por exatamente dois dígitos hexadecimais; portanto, <code>%</code>, <code>%2</code> e <code>%GG</code> causam erro de entrada inválida. Depois dessa verificação, os bytes escapados precisam formar UTF-8 válido. Uma sequência pode parecer plausível e ainda representar texto corrompido; aceitar caracteres substitutos esconderia danos em logs, retornos, assinaturas ou dados importados. Por isso, a ferramenta informa o erro. Ela não transforma sinais de adição em espaços: essa convenção pertence a formulários HTML, enquanto esta capacidade segue a RFC 3986. Também executa apenas uma passagem. Assim, <code>%2520</code> vira <code>%20</code>, e não um espaço. Uma segunda passagem deve ser solicitada de modo explícito, evitando decodificação dupla acidental.

Como usar o resultado com segurança

Selecione o modo conscientemente e envie a string exata que representa um único valor lógico. Ao codificar, insira o resultado sem aplicar outro codificador, pois a codificação dupla transforma cada porcentagem em <code>%25</code>. Ao decodificar, trate o texto resultante como dado, não como marcação confiável, caminho de arquivo ou instrução. Recuperar caracteres não valida o significado deles para o próximo destino. Essa distinção importa ao receber parâmetros de retorno, examinar logs, normalizar links ou comparar identificadores. O algoritmo não utiliza rede, aleatoriedade, relógio nem estado retido; entradas iguais geram saídas iguais. O navegador é prático para depurar um valor isolado, enquanto a API permite validações reproduzíveis em testes e pipelines. Cada item custa US$ 0,002 pela API.