Codificação 🔒 Roda no seu navegador — nenhum dado é enviado

Codificador e Decodificador de URL

Codifique e decodifique URLs, query strings e parâmetros em percentual, no seu navegador.

Entrada
Saída

Codificador e decodificador de URL - codificação percentual online

Uma URL só aceita um conjunto limitado de caracteres. Todo o resto - espaços, acentos, e comercial, barras dentro de um valor, emojis ou texto em árabe e japonês - precisa ser codificado em percentual antes de circular com segurança em um link, em uma query string ou no envio de um formulário. Este codificador e decodificador de URL gratuito faz a conversão na hora, nos dois sentidos e sem enviar nada para um servidor.

Cole o texto e clique em Codificar para obter uma string pronta para transporte, ou cole uma URL codificada e clique em Decodificar para lê-la em linguagem clara. O seletor de modo alterna entre encodeURIComponent e encodeURI, e é essa escolha que decide se o seu link funciona ou quebra em silêncio.

Diagrama: “a b&c=é” codificado caractere por caractere como “a%20b%26c%3D%C3%A9”.CaractereBytes UTF-8Codificadoa61a␣20%20b62b&26%26c63c=3D%3DéC3 A9%C3%A9Mantidos: letras, dígitos, - _ . ~Vira %XX
As letras passam sem mudança. O espaço e os caracteres reservados & e = viram %20, %26 e %3D, e o é primeiro é convertido em seus dois bytes UTF-8, C3 e A9, cada um escrito como %XX.

O que é codificação de URL

A codificação de URL, também chamada de codificação percentual, substitui um caractere inseguro por um sinal de porcentagem seguido do seu valor hexadecimal. Um espaço vira %20, uma barra vira %2F e uma interrogação vira %3F. Caracteres fora do ASCII são primeiro convertidos em bytes UTF-8 e depois codificados byte a byte, por isso uma única letra acentuada costuma gerar dois grupos percentuais e um emoji chega a gerar quatro.

encodeURIComponent ou encodeURI: qual modo usar

SituaçãoModoMotivo
Codificar o valor de um parâmetroencodeURIComponentEscapa &, =, ?, / e # para o valor não escapar do próprio campo
Codificar um segmento de caminho, como um slugencodeURIComponentImpede que uma barra dentro do valor crie um novo nível de caminho
Limpar uma URL completa que você já temencodeURIPreserva os caracteres estruturais e o endereço continua sendo uma URL válida
Passar uma URL de retorno dentro de outra URLencodeURIComponentA URL interna é um valor, não uma estrutura

Como codificar ou decodificar uma URL

  1. Cole o texto, o valor do parâmetro ou a URL completa no painel de entrada.
  2. Escolha encodeURIComponent para um valor isolado ou encodeURI para um endereço inteiro.
  3. Clique em Codificar para codificar ou em Decodificar para reverter.
  4. Copie a saída direto para o seu código, para a barra do navegador ou para o cliente de API.

Os caracteres que você mais vai encontrar

  • %20 - espaço. Em envios de formulário antigos você também verá + com o mesmo papel.
  • %2F - barra, codificada quando pertence ao valor e não ao caminho.
  • %3F e %26 - interrogação e e comercial, os dois delimitadores de parâmetros.
  • %3D - sinal de igual, que separa o nome do parâmetro do seu valor.
  • %23 - cerquilha, que de outra forma marca o início do fragmento.
  • %2B - sinal de mais, que precisa ser codificado ou pode ser lido como espaço.

Quando você precisa de um codificador de URL

  • Ao montar links de busca, filtro ou paginação em que a entrada do usuário vai parar na query string.
  • Ao passar uma URL de retorno como redirect_uri para um provedor OAuth ou um gateway de pagamento.
  • Ao adicionar parâmetros UTM de campanha que contêm espaços ou pontuação.
  • Ao decodificar um link de rastreamento longo recebido por e-mail para ver para onde ele realmente aponta.
  • Ao depurar uma chamada de API cujo parâmetro carrega JSON, um carimbo de tempo ou uma assinatura.
  • Ao lidar com slugs não latinos, para que um título em persa, japonês ou cirílico sobreviva ao copiar e colar.

Erros que quebram links

  • Codificação dupla. Codificar de novo uma string já codificada transforma %20 em %2520. Decodifique primeiro e codifique só uma vez.
  • Codificar a URL inteira com encodeURIComponent. O :// e as barras são escapados e o endereço deixa de ser uma URL.
  • Confundir + com %20. Na query string um mais pode significar espaço; no caminho significa um mais literal.
  • Esquecer o UTF-8. Páginas antigas codificadas em ISO-8859-1 produzem grupos que um decodificador moderno não consegue reverter.
  • Confiar em um valor decodificado. Decodificar não é sanitizar: valide a entrada antes de usá-la em uma consulta ou em HTML.

Roda inteiramente no seu navegador

O codificador usa as próprias funções JavaScript do navegador, então nada é enviado, armazenado ou registrado. Assim, URLs assinadas, identificadores de sessão e parâmetros com dados de clientes permanecem onde devem estar: na sua máquina.

Codificar URL em JavaScript, Python, PHP, Java e C#

LinguagemCodificar um valorObservações
JavaScriptencodeURIComponent(valor)encodeURI para um endereço completo
Pythonurllib.parse.quote(valor, safe='')quote_plus transforma espaços em +
PHPrawurlencode($valor)urlencode usa + para espaços
JavaURLEncoder.encode(valor, "UTF-8")Produz + para espaços; num caminho, troque por %20
C# / .NETUri.EscapeDataString(valor)HttpUtility.UrlEncode usa +
PowerShell[uri]::EscapeDataString($valor)Mesmas regras do .NET

Ferramentas relacionadas

URLs e payloads andam juntos. Decodifique binários embutidos com o codificador Base64, leia o token de uma URL de callback com o decodificador JWT, formate a resposta com o formatador JSON e teste padrões com o testador de expressões regulares.

Guias relacionados