Como usar a ferramenta Codificador / decodificador de URL
- Cole seu texto ou URLDigite o texto a codificar ou uma URL codificada para decodificar.
- Escolha o tipo de codificação“Componente” para um único valor de consulta ou trecho do caminho; “URL completa” para manter caracteres como : / ? & =.
- Codifique ou decodifiqueClique no botão que precisar. Marque “Espaços como +” para dados de formulários HTML.
- 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
| Modo | O que codifica | Para 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 completa | Espaç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.