URL Encode/Decode

Codifique ou decodifique texto para uso em URLs.

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.

Perguntas frequentes

O que é percent-encoding (URL encoding)?

É a técnica que representa caracteres especiais dentro de uma URL usando o símbolo "%" seguido de dois dígitos hexadecimais correspondentes ao byte do caractere em UTF-8. Por exemplo, o espaço vira "%20" e o "ã" vira "%C3%A3". Isso garante que a URL contenha apenas caracteres seguros para transitar por navegadores, servidores e links.

Por que espaços e acentos precisam ser codificados em uma URL?

O padrão de URLs (RFC 3986) reserva um conjunto limitado de caracteres ASCII para uso na estrutura do endereço (letras, números e alguns símbolos como "-", "_", ".", "~"). Espaços, acentos, emojis e símbolos como "&", "?" e "=" têm significado especial ou não são seguros para transmissão direta, então precisam ser convertidos em sequências "%XX" para não quebrar o link ou ser interpretados incorretamente.

Qual a diferença entre esta ferramenta e o Base64?

Percent-encoding (URL encode) e Base64 são codificações diferentes para propósitos diferentes. O percent-encoding foi criado especificamente para tornar um texto seguro dentro de uma URL, preservando caracteres já seguros e escapando apenas o necessário. O Base64 converte qualquer sequência de bytes em um alfabeto de 64 caracteres, sendo mais usado para transportar dados binários (como imagens) em formatos de texto, e não é otimizado para URLs.

Por que aparece um erro ao tentar decodificar meu texto?

Isso acontece quando o texto contém uma sequência "%" que não é seguida por dois dígitos hexadecimais válidos, ou quando os bytes decodificados não formam uma sequência UTF-8 válida. Verifique se você copiou o texto completo e se os símbolos de percentual fazem parte de um percent-encoding real.

Quando devo usar esta ferramenta?

Use para montar manualmente parâmetros de query string (por exemplo, ao construir um link com espaços, acentos ou símbolos no valor de um parâmetro), para depurar uma URL recebida de outro sistema, ou para entender o que uma URL codificada realmente significa antes de usá-la.