O que é percent-encoding
Percent-encoding, também conhecido como URL encoding, é o mecanismo usado para representar caracteres dentro de uma URL (endereço web) de forma segura. As URLs seguem um padrão (a RFC 3986) que define um conjunto restrito de caracteres ASCII permitidos diretamente na estrutura do endereço: letras (A-Z, a-z), números (0-9) e alguns símbolos como "-", "_", ".", "~". Qualquer outro caractere — um espaço, um acento, um emoji ou símbolos com significado especial na URL, como "&", "?", "#" e "=" — precisa ser convertido em uma sequência de escape no formato %XX, onde "XX" são dois dígitos hexadecimais que representam o valor do byte daquele caractere em UTF-8.
Por exemplo, o espaço em branco é representado como %20, a letra "ã" (que ocupa dois bytes em UTF-8) vira %C3%A3, e o símbolo "&" vira %26. Esse processo é totalmente reversível: decodificar a URL devolve exatamente o texto original, byte a byte.
Para que serve codificar e decodificar URLs
O uso mais comum do percent-encoding é em parâmetros de query string — a parte da URL depois do "?", como em busca?q=texto+livre. Sempre que o valor de um parâmetro contém espaços, acentos, símbolos de pontuação ou caracteres reservados (como "&" ou "="), é preciso codificá-lo para que o servidor e o navegador interpretem a URL corretamente, sem confundir o valor do parâmetro com a estrutura do endereço. Sem essa codificação, um espaço no meio da URL poderia quebrar o link, e um "&" dentro de um valor poderia ser confundido com o separador entre parâmetros diferentes.
Essa codificação também é essencial ao construir integrações entre sistemas, montar links de compartilhamento em redes sociais, gerar URLs de redirecionamento, passar tokens ou identificadores como parâmetro, e depurar URLs recebidas de APIs ou de outros serviços que chegam cheias de sequências %XX difíceis de ler a olho nu. Decodificar essas sequências permite entender rapidamente o conteúdo real de uma URL antes de reutilizá-la ou analisá-la.
Como usar esta ferramenta
Escolha o modo "Codificar" para transformar um texto comum — com espaços, acentos ou símbolos — em uma versão segura para uso dentro de uma URL, ou "Decodificar" para converter uma sequência de percent-encoding de volta ao texto original e legível. A conversão acontece automaticamente enquanto você digita ou cola o conteúdo, e você pode copiar o resultado com um clique. Caso o texto informado para decodificação não seja uma sequência de escape válida, esta ferramenta exibe uma mensagem clara explicando o problema.