Escolher idioma

Codificar URL Online (Percent-Encoding)

Converta texto e parâmetros em URLs seguras com percent-encoding. Codifique espaços, acentos e caracteres especiais direto no navegador.

Mehmet Demiray Publicado Atualizado
Compartilhar
Componente codifica caracteres reservados; completo mantém a estrutura da URL

O que significa codificar uma URL

Endereços na web só aceitam um conjunto limitado de caracteres considerados seguros: letras de A a Z, dígitos e alguns símbolos como -, _, . e ~. Quando um texto contém espaços, acentos, sinais de pontuação ou caracteres de outros alfabetos, esses valores precisam ser convertidos para um formato compatível antes de entrar numa URL.

Codificar uma URL, também chamado de percent-encoding, é justamente esse processo. Cada caractere fora da lista permitida vira uma sequência iniciada por % seguida de dois dígitos hexadecimais que representam o byte correspondente. Um espaço, por exemplo, costuma virar %20.

Isso garante que o servidor receba exatamente o valor que você quis enviar, sem que um & ou um ? no meio do texto seja interpretado como separador de parâmetro. A ferramenta da Callculation aplica essa conversão para você, transformando qualquer texto em uma versão pronta para colar em links, formulários ou requisições.

Como usar o codificador passo a passo

O fluxo foi pensado para ser direto, sem etapas desnecessárias. Você cola o conteúdo, confere o resultado e copia.

  1. Cole ou digite o texto que deseja codificar no campo de entrada.
  2. Veja a versão codificada aparecer no campo de saída de forma imediata.
  3. Use o botão de cópia para levar o resultado ao link ou requisição.

Todo o processamento acontece no próprio navegador. Nenhum texto é enviado a servidores externos, o que mantém valores sensíveis como tokens e parâmetros de busca sob seu controle.

Para o caminho inverso, quando você recebe um endereço cheio de sequências % e quer ler o conteúdo original, use o decodificador de URL. As duas ferramentas se complementam e funcionam com a mesma lógica de percent-encoding, então é comum alternar entre elas durante testes de integração ou ao depurar links que não abrem como esperado.

Quais caracteres são convertidos

Nem todo caractere precisa de codificação. Os chamados caracteres não reservados passam intactos, enquanto símbolos com função estrutural na URL e qualquer caractere fora do ASCII básico são transformados. Veja exemplos comuns:

Caractere Codificado
espaço %20
& %26
? %3F
= %3D
# %23
ç %C3%A7
ã %C3%A3

Observe que letras acentuadas, muito frequentes no português, ocupam dois bytes em UTF-8 e por isso geram duas sequências %. A palavra coração, por exemplo, vira cora%C3%A7%C3%A3o.

É por isso que copiar um link com acentos direto da barra de endereços e colar em outro lugar às vezes quebra o destino. Codificar antes evita esse tipo de falha e garante que o servidor reconstrua o texto original byte a byte.

Quando você realmente precisa codificar

A codificação entra em cena sempre que um valor dinâmico vai dentro de uma URL. Os casos mais comuns no dia a dia de quem trabalha com web são:

  • Parâmetros de busca: um termo digitado pelo usuário, como notebook 15 polegadas, precisa virar notebook%2015%20polegadas na query string.
  • Links de compartilhamento: títulos de páginas com acentos e pontuação que viajam em parâmetros.
  • APIs e webhooks: valores enviados via query que contêm &, = ou caracteres especiais.
  • Redirecionamentos: quando uma URL inteira é passada como parâmetro de outra.

Em cada situação, deixar o caractere cru pode fazer o servidor interpretar o valor de forma errada ou truncar a informação. Se o seu objetivo final é transformar um endereço já pronto em um código escaneável, vale combinar esta ferramenta com o gerador de QR Code de URL, garantindo que o link codificado funcione tanto no clique quanto na câmera.

Percent-encoding e Base64: diferenças

É comum confundir codificação de URL com Base64, já que ambos transformam texto em algo aparentemente embaralhado. Eles resolvem problemas diferentes, porém.

O percent-encoding mantém legível tudo o que já é seguro e só escapa o que atrapalharia a estrutura da URL. O resultado continua parecido com o texto original e é pensado especificamente para endereços web.

O Base64 converte qualquer dado, inclusive binário, em um alfabeto de 64 caracteres. Ele não foi feito para URLs e pode até gerar símbolos como + e /, que ainda precisariam de escape adicional.

Na prática, você usa percent-encoding para parâmetros e caminhos, e recorre ao codificador Base64 quando precisa embutir conteúdo binário ou um payload em texto. Entender essa separação evita escolher a ferramenta errada e gerar resultados que o servidor não consegue interpretar de volta.

As que mais respondemos.

Por que um espaço vira %20?

O espaço não faz parte do conjunto de caracteres seguros para URLs, então precisa ser escapado. Em percent-encoding, ele é representado pelo byte 20 em hexadecimal, resultando em %20. Em alguns contextos de formulário, o espaço também pode aparecer como +, mas %20 é a forma mais universal e aceita.

Meus dados são enviados para algum servidor?

Não. Toda a codificação acontece no seu navegador, em JavaScript. O texto que você cola nunca sai do seu dispositivo, o que é importante quando o valor inclui tokens, chaves ou parâmetros confidenciais.

Por que palavras com acento geram dois %?

Letras acentuadas como ç e ã são codificadas em UTF-8, onde cada uma ocupa dois bytes. Como cada byte vira uma sequência %XX, esses caracteres produzem duas sequências. Por isso ção aparece como %C3%A7%C3%A3o.

Devo codificar a URL inteira ou só o parâmetro?

Em geral, codifique apenas os valores que você insere na URL, não o endereço completo. Se você codificar a URL toda, símbolos estruturais como ://, ? e & também serão escapados e o link deixará de funcionar. Aplique a codificação a cada valor de parâmetro separadamente.

Como faço o processo inverso?

Para transformar um texto cheio de sequências % de volta no conteúdo original, use o decodificador de URL. Ele lê cada %XX e reconstrói os bytes, devolvendo acentos, espaços e símbolos no formato legível.

Qual a diferença entre codificar URL e usar Base64?

Percent-encoding escapa apenas os caracteres incompatíveis com URLs e mantém o restante legível. O Base64 converte qualquer dado em um alfabeto de 64 caracteres e não é pensado para endereços web. Para parâmetros e caminhos use a codificação de URL; para conteúdo binário, o codificador Base64.