Codificador / decodificador de URL

Codifique texto em porcentagem para usar com segurança em URLs e strings de consulta, ou decodifique URLs codificadas de volta para texto legível. Cole uma URL completa para ver suas partes detalhadas.

  • Modo componente ou URL completa
  • Codificação de formulário (+)
  • Detalhamento da URL

Como usar a ferramenta Codificador / decodificador de URL

  1. Cole seu texto ou URLDigite o texto a codificar ou uma URL codificada para decodificar.
  2. Escolha o tipo de codificação“Componente” para um único valor de consulta ou trecho do caminho; “URL completa” para manter caracteres como : / ? & =.
  3. Codifique ou decodifiqueClique no botão que precisar. Marque “Espaços como +” para dados de formulários HTML.
  4. Copie ou inspecioneCopie o resultado. Ao decodificar uma URL completa, protocolo, host, caminho e parâmetros de consulta aparecem numa tabela.

Recursos

  • Dois modos de codificaçãoEquivalem a encodeURIComponent e encodeURI do JavaScript, as duas funções que os desenvolvedores mais usam.
  • RFC 3986 estritoO modo componente também codifica ! ' ( ) *, que alguns servidores tratam de forma especial.
  • Codificação de formulárioConverta espaços em + e vice-versa, como em application/x-www-form-urlencoded.
  • Detalhamento da URLLeia de relance cada parâmetro de uma URL longa de rastreamento ou de API.

O que é codificação de URL?

URLs só podem conter um conjunto limitado de caracteres: letras inglesas, dígitos e alguns símbolos como - _ . ~. Os outros, incluindo espaços, letras com acento e ç, e os símbolos com significado especial numa URL (como ?, & e #), precisam ser codificados com porcentagem. Cada byte é escrito como um % seguido de dois dígitos hexadecimais. Um espaço vira %20, & vira %26 e ã vira %C3%A3 (os dois bytes UTF-8 dele).

Acentos e ç nas URLs

É por isso que um link como example.com/promoção?cidade=São Paulo vira example.com/promo%C3%A7%C3%A3o?cidade=S%C3%A3o%20Paulo ao ser copiado. Cole aqui um link assim e decodifique para ler de novo com os acentos. Para criar endereços limpos desde o começo, gere slugs sem acentos com o Gerador de slug. Se você colar uma URL completa, vê as partes dela e cada parâmetro separadamente.

Componente ou URL completa

ModoO que codificaPara quê
Componente (valores de consulta, partes do caminho)Tudo exceto letras, dígitos e - _ . ~Um valor de parâmetro, um segmento de caminho, um nome de arquivo
URL completaEspaços e caracteres inseguros, mas mantém : / ? # & = +Uma URL inteira que já tem a estrutura correta

Exemplo: para colocar «pão & café» em ?q=, codifique como componente: p%C3%A3o%20%26%20caf%C3%A9. No modo URL completa, o & ficaria como está e o servidor acharia que ali começa outro parâmetro. Os modos equivalem ao encodeURIComponent e ao encodeURI do JavaScript; o modo componente segue estritamente a RFC 3986 e também codifica ! ' ( ) *.

%20 ou +?

Os dois podem representar um espaço, mas em lugares diferentes. Na query string de formulários HTML (application/x-www-form-urlencoded), espaços são escritos como +. No resto da URL, inclusive no caminho, um espaço precisa ser %20. Marque «Espaços como + (codificação de formulário)» só quando estiver trabalhando com dados de formulário.

Problemas comuns que ela resolve

  • Codificação dupla: %2520 numa URL significa que um %20 foi codificado de novo. Decodifique duas vezes para obter o texto original.
  • Links quebrados: URLs copiadas de documentos podem ter espaços ou caracteres especiais sem codificação. Codifique no modo URL completa.
  • Ler links de rastreamento: decodifique links longos de marketing ou de redirecionamento para ver para onde eles levam de verdade e quais parâmetros UTM carregam; crie os seus com o Gerador de UTM.
  • Erros «URI malformed»: um % solto sem dois dígitos hexadecimais depois não pode ser decodificado. Troque por %25.

Perguntas frequentes

O que significa %20 numa URL?
%20 é a forma codificada de um espaço. Da mesma forma, %2F é uma barra e %26 é um &.
Qual a diferença entre encodeURI e encodeURIComponent?
encodeURI mantém os caracteres que estruturam uma URL, como : / ? & =. encodeURIComponent também os codifica, que é o que você precisa para o valor de um único parâmetro.
Por que dá erro ao decodificar?
A entrada tem um sinal % que não é seguido de dois dígitos hexadecimais válidos. Codifique um sinal de porcentagem literal como %25.
O que significa %20 numa URL?
%20 é a forma codificada de um espaço. Do mesmo jeito, %2F é uma barra e %26 um e comercial.
Qual a diferença entre encodeURI e encodeURIComponent?
O encodeURI mantém os caracteres que estruturam uma URL, como : / ? & =. O encodeURIComponent também codifica esses caracteres, que é o que você precisa para o valor de um parâmetro.
Por que dá erro ao decodificar?
A entrada tem um sinal % que não é seguido de dois dígitos hexadecimais válidos. Codifique uma porcentagem literal como %25.
Funciona com acentos, ç e outros alfabetos?
Sim. Os caracteres viram bytes UTF-8 e cada byte é codificado com porcentagem, que é o padrão da web.
Meus dados são enviados para algum lugar?
Não. A codificação e a decodificação são feitas no seu navegador.