Codificação de URL explicada: o que significa %20 e como codificar ou decodificar um link
Por que links mostram %20 e %2F, tabela de códigos comuns, componente ou URL completa, + ou %20, dupla codificação e links de rastreamento.
Atualizado em 4 de novembro de 20268 min de leitura
A codificação de URL, também chamada de codificação percentual, reescreve os caracteres que não podem aparecer como estão em um endereço da web como um sinal de porcentagem seguido de dois dígitos hexadecimais. Um espaço vira %20, uma barra vira %2F, um ponto de interrogação vira %3F, e uma letra acentuada vira dois ou três desses códigos em sequência. Isso existe porque uma URL usa caracteres como ? & = # e / como pontuação: se o seu próprio texto os contiver, é preciso escapá-los, ou o endereço passa a significar outra coisa. Cole o texto no codificador e decodificador de URL, escolha Codificar ou Decodificar e o resultado aparece enquanto você digita. Tudo roda no seu dispositivo, não nos nossos servidores.
Por que as URLs precisam de codificação
Um endereço da web é feito de partes separadas por pontuação. A barra divide o caminho, o ponto de interrogação abre a consulta, o e comercial separa um parâmetro do seguinte, o sinal de igual liga um nome ao seu valor e o jogo da velha abre o fragmento. Esses caracteres são chamados de reservados, porque carregam a estrutura do endereço.
O problema começa quando os próprios dados contêm um deles. Uma busca por fish & chips colocada direto em um link resulta em ?q=fish & chips, que o servidor lê como um parâmetro q com o valor “fish ” e depois um segundo parâmetro vazio chamado “ chips”. Escrito como fish%20%26%20chips, nada fica ambíguo. Codificar não torna um link secreto nem mais seguro de abrir. Apenas deixa inequívoco o significado de cada caractere.
Os códigos que você mais vai ver
| Caractere | Código | Onde aparece |
|---|---|---|
| Espaço | %20 | Nomes e títulos em um caminho ou consulta. Em formulários também se escreve + |
| / | %2F | Uma barra dentro de um valor, como uma URL aninhada ou um caminho de arquivo |
| ? | %3F | Um ponto de interrogação que faz parte dos dados, não da consulta |
| & | %26 | Um e comercial dentro de um valor, como “Tom & Jerry” |
| = | %3D | Um sinal de igual dentro de um valor, comum no preenchimento do Base64 |
| # | %23 | Um jogo da velha que não deve abrir o fragmento, como uma hashtag |
| % | %25 | Um sinal de porcentagem literal; ele também precisa ser escapado |
| + | %2B | Um sinal de mais de verdade, como em um telefone ou em um alias de e-mail |
| : | %3A | Os dois-pontos de https:// quando um link inteiro é passado como valor |
| @ | %40 | Um endereço de e-mail usado como valor |
| , | %2C | Listas de valores separados por vírgulas |
| " | %22 | Aspas em um texto de busca |
Como codificar ou decodificar uma URL
Abra a ferramenta e escolha o sentido
Abra o codificador e decodificador de URL. Escolha Codificar para transformar texto em sequências de escape, ou Decodificar para lê-las como texto comum.
Cole o texto
Digite ou cole na caixa de entrada. O resultado é atualizado ao vivo, então não há nada para apertar. Você também pode soltar um arquivo de texto com um link por linha e ativar Converter cada linha separadamente.
Escolha o Perfil de codificação
Use Componente para um único valor, URL completa para um link inteiro, RFC 3986 estrito para OAuth 1.0 ou assinatura de requisições AWS, e Formulário para o que um navegador envia ao submeter um formulário. A próxima seção explica a diferença.
Copie o resultado
Copie ou baixe como arquivo de texto. Usar a saída como entrada inverte o sentido para você conferir se o texto volta idêntico.
Quatro perfis de codificação, resultado ao vivo e um detalhamento de cada parâmetro de consulta. Grátis: um arquivo de texto de até 10 MB por vez. Pro: 20 arquivos e um único download em ZIP. Tudo roda no seu dispositivo, não nos nossos servidores.
Codificar ou decodificar uma URLComponente ou URL completa?
Essa é a escolha que causa mais erros. Um componente é uma peça que você coloca em um link: um valor de consulta, um nome, um segmento de caminho. Uma URL completa é um endereço pronto, cuja pontuação já está no lugar certo. A codificação de componente escapa a pontuação, porque dentro de um valor esses caracteres são apenas dados. A codificação de URL completa a deixa como está, porque ela está cumprindo seu papel.
| Perfil | Deixa literal | Use para |
|---|---|---|
| Componente | Letras, dígitos e - _ . ! ~ * ' ( ) | Um valor de consulta ou segmento de caminho. A escolha segura padrão |
| RFC 3986 estrito | Só letras, dígitos e - . _ ~ | OAuth 1.0 e assinatura de requisições AWS, que escapam também ! ' ( ) * |
| URL completa | O acima mais : / ? # & = + $ , ; @ | Limpar um link inteiro que já tem a forma correta |
| Formulário | Letras, dígitos e * - . _ ; o espaço vira + | O que um navegador envia ao submeter um formulário |
Uma regra prática: se você monta um link com peças, codifique cada peça como componente e junte-as você mesmo. Codificar o link pronto como componente transformaria https:// em https%3A%2F%2F e o endereço deixaria de funcionar. O erro oposto, codificar um valor no modo URL completa, deixa intacto um e comercial dentro dele, e esse e comercial parte o seu valor em dois.
Ao decodificar, há uma proteção que vale conhecer. No modo URL completa, %2F continua %2F por padrão, porque transformá-lo em uma barra de verdade acrescentaria um segmento de caminho que nunca existiu. Se preferir texto legível, marque Decodificar também : / ? & =.
Sinal de mais ou %20 para um espaço?
Os dois significam um espaço, mas não nos mesmos lugares. %20 está correto em qualquer lugar. O sinal de mais significa espaço apenas em dados no estilo de formulário, isto é, a parte do link depois do ponto de interrogação e o corpo de um formulário enviado. Em um caminho, o mais é só um mais. Assim, /meu+arquivo.pdf é um arquivo que se chama mesmo meu+arquivo.pdf, enquanto ?q=meu+arquivo significa o texto de busca “meu arquivo”.
A ferramenta aplica essa regra. Com Tratar + como espaço ativado, ao decodificar um link completo o mais vira espaço apenas depois do primeiro ponto de interrogação, e o caminho não é tocado. Se quiser um sinal de mais real em um valor, codifique-o como %2B; deixá-lo sem escape em uma consulta é o motivo de um telefone como +55 11 91234 5678 chegar com o mais trocado por um espaço.
Letras acentuadas, outros alfabetos e emojis
Os códigos percentuais representam bytes, não letras. Antes do escape, o texto é convertido para UTF-8, a codificação que quase todos os sites modernos usam. As letras inglesas ocupam um byte, mas outros caracteres precisam de mais, e cada byte recebe seu próprio código. Por isso um único caractere visível pode virar uma sequência de códigos.
| Caractere | Bytes em UTF-8 | Codificado |
|---|---|---|
| é | 2 | %C3%A9 |
| € | 3 | %E2%82%AC |
| 日 | 3 | %E6%97%A5 |
| 😀 | 4 | %F0%9F%98%80 |
Um endereço codificado pode ser várias vezes mais longo que o texto digitado. Sistemas antigos às vezes esperam outro conjunto de caracteres, como Windows-1252 ou Shift_JIS, no qual %E9 sozinho significa é. Se a decodificação mostrar pontos de interrogação ou símbolos estranhos, mude o ajuste Conjunto de caracteres de UTF-8 para o que o sistema antigo usava. Para trabalho novo, deixe em UTF-8.
Dupla codificação e outros erros
O sintoma clássico é %2520 onde você esperava %20. Acontece quando um trecho de código codifica um valor e um segundo trecho, que não sabe disso, o codifica de novo. A primeira passagem transforma um espaço em %20. A segunda transforma o % em %25, dando %2520. Cada camada extra acrescenta mais um 25.
- Ponha Passagens repetidas acima de 1. A ferramenta decodifica até cinco vezes, para assim que uma passagem não muda mais nada e informa quantas passagens o texto realmente precisou.
- Uma sequência cortada. Um link copiado que termina em %E ou %4 está quebrado. Com Recuperar de sequências danificadas ativado, a ferramenta mantém tudo o que é válido e indica onde está cada sequência defeituosa, em vez de rejeitar a cadeia inteira.
- Escapes antigos %u00E9. Cadeias de uma função de script já aposentada usam %u mais quatro dígitos hexadecimais. A ferramenta tem uma chave para lê-las.
- Um mais perdido. Veja a seção acima; codifique um sinal de mais real como %2B.
Decodificando um link de rastreamento confuso
Links de newsletters, anúncios e publicações compartilhadas costumam embrulhar o destino real dentro de um endereço de redirecionamento e depois codificá-lo uma ou duas vezes. Um exemplo inventado: https://track.example/go?url=https%253A%252F%252Fshop.example%252Fp%253Fid%253D42%2526ref%253Dmail&utm_source=news+letter
Cole-o, escolha Decodificar e ponha Passagens repetidas em 2 ou mais. Uma passagem dá url=https%3A%2F%2Fshop.example%2Fp%3Fid%3D42%26ref%3Dmail, ainda codificado. A segunda dá url=https://shop.example/p?id=42&ref=mail, o destino real. Olhe também o Detalhe do URL: ele lista cada parâmetro de consulta decodificado separadamente (“Parâmetros de consulta, cada um decodificado separadamente”), e você vê que utm_source vale “news letter” e qual parâmetro embrulha o link.
Ler um link assim também é uma verificação barata de segurança, pois você vê para onde ele realmente leva antes de abri-lo. Lembre-se de que decodificar só revela o que está escrito; não diz se o destino é confiável. Para compartilhar o endereço limpo como código, crie um com o gerador de QR Code. Para dados que não são um link, como um arquivo dentro de um JSON, veja o que é a codificação Base64.
Perguntas frequentes
O que significa %20 em uma URL?
É um espaço. Uma URL não pode conter um espaço literal, então ele é escrito como um sinal de porcentagem seguido de 20, seu valor em hexadecimal. Ao decodificar, cada %20 volta a ser um espaço.
Como codificar uma URL de graça?
Abra o codificador e decodificador de URL, escolha Codificar, selecione o perfil Componente para um único valor e cole o texto. O resultado é atualizado enquanto você digita e pode ser copiado com um clique. Roda no seu dispositivo, não nos nossos servidores.
Como decodificar uma URL com %20 e %2F?
Escolha Decodificar e cole o link. Para um endereço inteiro use o perfil URL completa; note que %2F continua %2F por padrão, e marcar Decodificar também : / ? & = o transforma em barra. Use Passagens repetidas se ainda sobrarem códigos depois.
Qual a diferença entre encodeURI e encodeURIComponent?
encodeURI é feita para um endereço inteiro e não mexe em : / ? # & =. encodeURIComponent é feita para uma única peça e os escapa. Na ferramenta, são os perfis URL completa e Componente.
Por que minha URL mostra %2520?
Ela foi codificada duas vezes. A primeira passagem gerou %20 e a segunda transformou o sinal de porcentagem dele em %25. Decodifique com Passagens repetidas em 2 ou mais e corrija o código que codifica o valor pela segunda vez.
Codificar uma URL é o mesmo que criptografar?
Não. Qualquer pessoa decodifica em um segundo e nada fica escondido. Ela só garante que caracteres especiais não sejam confundidos com a estrutura do endereço.