Codificador e Decodificador de URL
Codifique e decodifique URLs, query strings e parâmetros em percentual, no seu navegador.
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.
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ção | Modo | Motivo |
|---|---|---|
| Codificar o valor de um parâmetro | encodeURIComponent | Escapa &, =, ?, / e # para o valor não escapar do próprio campo |
| Codificar um segmento de caminho, como um slug | encodeURIComponent | Impede que uma barra dentro do valor crie um novo nível de caminho |
| Limpar uma URL completa que você já tem | encodeURI | Preserva os caracteres estruturais e o endereço continua sendo uma URL válida |
| Passar uma URL de retorno dentro de outra URL | encodeURIComponent | A URL interna é um valor, não uma estrutura |
Como codificar ou decodificar uma URL
- Cole o texto, o valor do parâmetro ou a URL completa no painel de entrada.
- Escolha
encodeURIComponentpara um valor isolado ouencodeURIpara um endereço inteiro. - Clique em Codificar para codificar ou em Decodificar para reverter.
- 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.%3Fe%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_uripara 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
%20em%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#
| Linguagem | Codificar um valor | Observações |
|---|---|---|
| JavaScript | encodeURIComponent(valor) | encodeURI para um endereço completo |
| Python | urllib.parse.quote(valor, safe='') | quote_plus transforma espaços em + |
| PHP | rawurlencode($valor) | urlencode usa + para espaços |
| Java | URLEncoder.encode(valor, "UTF-8") | Produz + para espaços; num caminho, troque por %20 |
| C# / .NET | Uri.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.