🧰 ToolPicoTodas as ferramentas →

Codificador / Descodificador URL

Codifica texto com encodeURIComponent/encodeURI, descodifica uma cadeia codificada em percentagem, analisa ou constrói uma query string, decompõe um URL completo nas suas partes — além de codificação/descodificação Base64 e um limpador de parâmetros de tracking. Tudo é executado no teu navegador, nada é enviado para um servidor.

6 modos numa só ferramenta 100% no cliente Norma: RFC 3986 Atualizado: 26 jul. 2026
As letras acentuadas, os emoji e os símbolos especiais são totalmente compatíveis.
Codificação de formulário (+ para o espaço)Estilo application/x-www-form-urlencoded: «+» em vez de %20
Cola uma cadeia codificada em percentagem (%XX), ou um URL inteiro codificado.
Descodificação multinível (aninhada)Resolve valores duplamente codificados como %2520 através de cada camada
Cada linha é processada de forma independente; os resultados voltam pela mesma ordem. Ideal para codificar/descodificar dezenas de ligações ou parâmetros de uma vez e copiá-los todos juntos.
Os parâmetros são descodificados automaticamente; os parâmetros de tracking conhecidos (UTM/gclid/fbclid) são assinalados.
Deixa este campo vazio para gerar apenas uma query string ?chave=valor.
Decompõe um URL em protocolo, anfitrião, porta, caminho, query e fragmento (hash).
Resposta rápida A codificação URL (codificação percentual) converte os caracteres que não podem aparecer num URL — espaços, letras acentuadas, emoji e símbolos reservados como &, ? e # — num formato seguro %XX. encodeURIComponent() codifica um único valor de parâmetro; encodeURI() codifica um endereço inteiro. decodeURIComponent() inverte qualquer uma das duas.
UTF-8Norma de codificação de caracteres
RFC 3986Norma de codificação percentual de URI
%20Código percentual de um espaço
GrátisIlimitado, sem registo
⚙️ Nota sobre privacidade: toda a codificação, descodificação e análise é feita diretamente no teu navegador (JavaScript no cliente). O texto ou o URL que introduzes nunca é enviado para um servidor, nem guardado, nem registado. O botão «Partilhar» só codifica a tua entrada numa ligação se escolheres usá-lo — pensa com quem partilhas essa ligação antes de incluir informação sensível.
🔗 Codificador / Descodificador URL — ToolPico ↗

O que é a codificação URL, e como funciona?

Um guia completo sobre a codificação percentual, a diferença entre encodeURIComponent e encodeURI, as query strings e Base64.

Um URL só consegue transportar diretamente um conjunto limitado de caracteres — letras, números e alguns símbolos não reservados. Os espaços, as letras acentuadas (como é, ü, ã), os emoji e os caracteres & ? # % + = — os caracteres reservados que estruturam um URL — têm de ser convertidos primeiro para o formato %XX, um processo chamado codificação percentual ou, mais comummente, codificação URL. A operação inversa é a descodificação URL. A ferramenta acima trata de ambos os sentidos, além da análise/construção de query string, a análise de URL completo e Base64, instantaneamente no teu navegador.

Qual é a diferença entre encodeURIComponent e encodeURI?

Resposta rápidaencodeURIComponent() codifica UMA ÚNICA parte de um URL — por exemplo um valor de consulta — e também codifica caracteres estruturais como & = ? / : #, o que o torna a opção adequada para valores de parâmetro. encodeURI() serve para codificar um endereço INTEIRO; deixa intactos os caracteres que um URL precisa para funcionar — : / ? # & =.
  • encodeURIComponent("a&b=c") → a%26b%3Dc (& e = também são codificados — correto para um único VALOR de parâmetro)
  • encodeURI("https://x.com/a b?c=1&d=2") → https://x.com/a%20b?c=1&d=2 (só o espaço é codificado; a estrutura do URL é preservada)

Como se codificam os caracteres acentuados e os emoji num URL?

Resposta rápidaOs navegadores usam a codificação UTF-8 para os URL. Cada letra acentuada ou emoji converte-se primeiro em bytes UTF-8, e depois cada byte é escrito no seu próprio valor %XX. Por exemplo, é ocupa 2 bytes e converte-se em %C3%A9; um emoji de 4 bytes converte-se em quatro grupos %XX distintos. Nunca precisas de calcular isto à mão — encodeURIComponent() faz isso automaticamente.
Caracteres comuns e a sua forma codificada em percentagem (UTF-8)
CarácterSignificadoForma codificada
(espaço)Carácter espaço%20 (ou + em formulários)
éLetra acentuada, ex. café%C3%A9
ãLetra acentuada, ex. amanhã%C3%A3
&Separador de parâmetros%26
=Separador chave-valor%3D
?Início da query string%3F
#Início do fragmento/âncora%23
%O próprio sinal de percentagem%25
🚀Emoji (UTF-8 de 4 bytes)%F0%9F%9A%80

Como se constrói e analisa uma query string?

Resposta rápidaUma query string é o conjunto de pares chave=valor que seguem o ? num URL, separados por &. O separador «Construir Query» acima permite introduzir pares chave-valor e gera uma query string corretamente codificada em percentagem; o separador «Analisar Query» pega num URL existente e converte cada parâmetro numa tabela legível. A ferramenta também assinala automaticamente os parâmetros de tracking conhecidos como utm_source, gclid e fbclid.

Em que se diferencia a codificação Base64 da codificação URL?

Resposta rápidaBase64 converte quaisquer dados binários ou de texto num alfabeto de 64 caracteres (A-Z a-z 0-9 + /); usa-se habitualmente para tokens, chaves de API ou incorporar ficheiros pequenos como texto, e não tem nada a ver com a estrutura de um URL. A codificação URL torna especificamente seguros os caracteres especiais dentro de um URL. Como a saída Base64 contém caracteres + e /, às vezes precisa de um passo adicional por encodeURIComponent() antes de poder entrar num parâmetro de URL — experimenta-o na secção de mini-ferramentas abaixo.

Exemplos populares de codificação e descodificação de URL

Conversões habituais que podes abrir diretamente — cada uma preenche a ferramenta acima com o modo e a entrada corretos.

Mini-ferramentas: Base64, Query → JSON, Limpador de URL

Três pequenas ferramentas frequentemente necessárias junto com a codificação/descodificação de URL — todas executadas no teu navegador.

🔤Codificador/Descodificador Base64
Converte texto para Base64, ou Base64 para texto (compatível com Unicode).
🧩Query String → JSON
Cola uma query string ou um URL, converte os seus parâmetros num objeto JSON.
🧹Limpador de URL
Remove parâmetros UTM, gclid, fbclid e outros parâmetros de tracking para obter uma ligação limpa.

Tabelas de referência e dados práticos

Classes de caracteres RFC 3986 citáveis, uma comparação encodeURI vs encodeURIComponent, e os parâmetros de tracking mais comuns.

RFC 3986 — caracteres não reservados e reservados
ClasseCaracteres
Não reservados (nunca são codificados)A-Z a-z 0-9 - _ . ~
Delimitadores gerais (gen-delims): / ? # [ ] @
Subdelimitadores (sub-delims)! $ & ' ( ) * + , ; =
Tudo o restoÉ sempre codificado em percentagem (espaços, letras acentuadas, emoji, bytes não ASCII, etc.)

Fonte: RFC 3986 (Uniform Resource Identifier — Generic Syntax), IETF.

Caracteres que cada função de codificação de JavaScript deixa intactos
FunçãoDeixa sem codificar
encodeURIComponent()A-Z a-z 0-9 - _ . ! ~ * ' ( )
encodeURI()O anterior, mais ; / ? : @ & = + $ , #
decodeURIComponent()Descodifica sequências %XX; lança um URIError perante uma sequência inválida

Regra prática: usa encodeURIComponent para um único VALOR de parâmetro, e encodeURI para um URL completo.

Parâmetros de consulta de tracking habituais
ParâmetroOrigem / significado
utm_source, utm_medium, utm_campaignEtiquetas de campanha do Google Analytics
utm_term, utm_contentEtiquetas de palavra-chave / variante de anúncio
gclidIdentificador de clique do Google Ads
fbclidIdentificador de clique da Meta (Facebook/Instagram)
msclkidIdentificador de clique do Microsoft Ads (Bing)
mc_cid, mc_eidIdentificador de campanha de email do Mailchimp
igshid, ref_src, refEtiquetas de referência do Instagram / genéricas

O separador «Analisar URL» e a mini-ferramenta «Limpador de URL» acima reconhecem e assinalam/removem automaticamente estes parâmetros.

Adiciona esta ferramenta ao teu site (código de integração)

Integra gratuitamente a ferramenta de codificação/descodificação de URL no teu próprio site. Copia o código abaixo para o teu HTML — a ferramenta é mostrada numa vista simplificada e liga a esta página como fonte.

A ferramenta integrada tem um design fixo; podes ajustar o valor de height conforme o teu site. Sem publicidade nem dados pessoais, funciona inteiramente no cliente.

Glossário de termos de URL e codificação

Definições breves dos conceitos essenciais da codificação e descodificação de URL.

URI / URLUm URI é o formato geral para identificar um recurso; um URL (Uniform Resource Locator) é o tipo de URI mais comum, que indica também como encontrar o recurso.
Codificação percentualO método de representar caracteres reservados ou não ASCII como sequências %XX (byte hexadecimal); sinónimo de codificação URL.
Caracteres reservados / não reservadosSegundo a RFC 3986, os caracteres não reservados (letras, números, - _ . ~) nunca são codificados; os caracteres reservados (: / ? # & = etc.) sustentam a estrutura do URL.
Query stringOs parâmetros chave=valor que seguem o «?» num URL, separados por «&».
Fragmento / hash (#)A parte de um URL depois de «#»; nunca é enviada ao servidor e é usada para a navegação dentro da página ou o estado no cliente.
encodeURIComponent()Uma função de JavaScript que codifica um único componente de URL (um valor de parâmetro), codificando também os caracteres estruturais.
encodeURI()Uma função de JavaScript que codifica um URL inteiro deixando intactos os caracteres que a estrutura do URL precisa.
Codificação dupla / aninhadaCodificar uma cadeia já codificada uma segunda vez; «%25» (o código do sinal de percentagem literal) costuma ser o sinal disso.
Base64Uma codificação de propósito geral que representa dados binários ou de texto com um alfabeto de 64 caracteres, independente da estrutura do URL.
Parâmetros UTMEtiquetas derivadas do Google Analytics — utm_source, utm_medium, utm_campaign, etc. — acrescentadas a uma query string para rastrear campanhas de marketing.
PunycodeUma codificação distinta que converte nomes de domínio internacionalizados para ASCII; diferente da codificação URL, e usada apenas para nomes de anfitrião.
application/x-www-form-urlencodedO formato de envio por defeito dos formulários HTML; codifica um espaço como «+» em vez de %20.

Guias em profundidade

Respostas detalhadas às perguntas mais frequentes sobre a codificação de URL.

Os meus caracteres acentuados aparecem deformados ao partilhar um URL — o que faço?

Quando se acrescentam caracteres acentuados a um URL sem codificar (em bytes UTF-8 crus), algumas aplicações, plataformas de mensagens ou sistemas antigos podem interpretá-los mal, produzindo texto deformado (mojibake). A solução é codificar o texto com encodeURIComponent() antes de o partilhar: uma palavra como «café» converte-se em «caf%C3%A9» e é descodificada corretamente ao recebê-la.

Cola o teu texto no separador «Codificar» acima e escolhe o modo «URI completo» para preservar intacta a estrutura do endereço codificando apenas os caracteres problemáticos; depois usa o resultado diretamente na barra de endereços do teu navegador ou partilha-o como ligação.

Ao que devo prestar atenção ao ler os parâmetros de uma query string?

Para examinar uma query string, separa-a primeiro em parâmetros por cada &, e depois separa cada parâmetro em chave e valor pelo =; os valores costumam estar codificados em percentagem, por isso é preciso descodificá-los para que sejam legíveis. Tem também em conta que parâmetros como utm_*, gclid e fbclid não são dados funcionais — são etiquetas de tracking de marketing, e talvez queiras removê-los antes de partilhar uma ligação.

O separador «Analisar Query» acima faz esta análise automaticamente e destaca a âmbar os parâmetros de tracking; a mini-ferramenta «Limpador de URL» remove-os com um clique.

Que codificação usar ao chamar uma API?

Quando enviares um parâmetro de consulta para uma API REST, codifica sempre o valor com encodeURIComponent() — sobretudo se contiver espaços, «&» ou letras acentuadas — porque esse valor é apenas um COMPONENTE do URL. Se enviares JSON no corpo do pedido, não é preciso codificação adicional, já que o JSON tem as suas próprias regras de escape. Usa encodeURI apenas se codificares de uma só vez um URL inteiro já construído; caso contrário, arriscas codificar caracteres necessários como «?» e «&» e quebrar o pedido.

Perguntas frequentes

O que é a codificação URL?
A codificação URL (codificação percentual) converte os caracteres que não podem ser usados diretamente num URL — espaços, letras acentuadas, símbolos reservados como & ? #, e emoji — para o formato %XX que os navegadores entendem. Por exemplo, um espaço converte-se em %20, e «é» converte-se em %C3%A9. Isto permite acrescentar texto de forma segura a um endereço ou parâmetro sem quebrar a estrutura do URL.
Como se codifica um texto para um URL?
Num navegador, usa as funções de JavaScript encodeURIComponent() ou encodeURI(), ou uma ferramenta online como esta. Cola o teu texto no separador «Codificar», escolhe um modo e clica em Codificar; depois copia o resultado e acrescenta-o a um URL ou um parâmetro de consulta.
O que é encodeURIComponent?
encodeURIComponent() é uma função de JavaScript usada para codificar UMA ÚNICA parte de um URL (um valor de consulta, um parâmetro); também codifica caracteres estruturais como & = ? / :. Se estiveres a codificar um VALOR em vez de um endereço completo, é a função que deves usar.
Como se constrói uma query string?
Uma query string é o conjunto de pares chave=valor que seguem o «?» num URL, unidos por & (ex. ?cor=vermelho&tamanho=42). Introduz os teus pares chave-valor no separador «Construir Query» e clica em Construir; os valores são codificados automática e corretamente numa query string completa ou um URL completo.
Como se codificam os caracteres acentuados num URL?
Os navegadores modernos usam UTF-8 nos URL; cada carácter acentuado converte-se numa sequência %XX%XX de 2 bytes (ex. «é» → %C3%A9). encodeURIComponent() e encodeURI() realizam esta conversão automática e corretamente.
O que é a codificação/descodificação Base64?
Base64 é uma codificação binário-texto de propósito geral que representa os dados com um alfabeto de 64 caracteres (A-Z, a-z, 0-9, +, /); usa-se para tokens, imagens ou incorporar ficheiros pequenos. É distinta da codificação URL, que codifica especificamente os caracteres especiais dentro de um URL. Experimenta ambas na secção de mini-ferramentas acima.
O que é a descodificação URL, e como se faz?
A descodificação URL converte uma cadeia codificada em percentagem (%XX) no seu texto original e legível; é o contrário da codificação. Cola o texto codificado no separador «Descodificar» e clica em Descodificar; para um texto codificado mais de uma vez (aninhado), a opção «descodificação multinível» resolve cada camada num único passo.
Porque é que às vezes vejo um valor duplamente codificado como %2520?
%2520 resulta de codificar um %20 já codificado (um espaço) uma segunda vez, porque o próprio «%» é codificado como %25. Costuma ser causado por um sistema que codifica por engano os mesmos dados duas vezes. A opção «descodificação multinível» no separador «Descodificar» resolve cada camada aninhada até chegar ao texto original numa única passagem.
Posso codificar ou descodificar vários URL de uma vez (em massa)?
Sim. Cola um texto ou um URL por linha no separador «Massa», escolhe a operação (encodeURIComponent, encodeURI, ou decode), e clica em Executar; cada linha é processada de forma independente e os resultados voltam pela mesma ordem. Assim podes processar dezenas de ligações ou parâmetros de uma vez em vez de um a um. Tudo é executado no teu navegador — nenhuma linha é alguma vez enviada para um servidor.

Metodologia e fontes

A ferramenta de codificação / descodificação URL da ToolPico é uma ferramenta gratuita e independente. A codificação e descodificação são realizadas diretamente com as funções nativas do navegador encodeURIComponent() / encodeURI() / decodeURIComponent() (baseadas em UTF-8, em conformidade com a RFC 3986); a análise de URL usa a API Web URL(), e a conversão Base64 usa um wrapper compatível com UTF-8 em torno de btoa()/atob(). Nenhum cálculo é alguma vez enviado para um servidor.

Fontes: RFC 3986 (Uniform Resource Identifier — Generic Syntax, IETF) · WHATWG URL Standard · MDN Web Docs (encodeURIComponent, encodeURI, URL). Última atualização: 26 de julho de 2026. Os resultados são disponibilizados apenas para fins informativos.

🔗 Adiciona esta ferramenta ao teu site

Copia o código abaixo para o teu próprio site. A ferramenta é gratuita, está sempre atualizada, e funciona inteiramente na tua página. Não requer registo.

Pré-visualizar →
⚡ Criado com a ToolPico · toolpico.com