Codificador / decodificador de URL — codifique e decodifique URLs com porcentagem

O que é um Codificador / decodificador de URL?

Um Codificador / decodificador de URL (URL एनकोडर / डिकोडर) converte texto numa forma que pode viajar com segurança dentro de um endereço web e o converte de volta. As URLs só podem conter um conjunto limitado de caracteres, e alguns deles — como ?, &, =, # e / — têm funções especiais. Todo o resto, incluindo espaços, aspas, letras hindi, emoji e símbolos como ₹, deve ser codificado com porcentagem: substituído por um sinal % seguido de dois dígitos hexadecimais para cada byte. Um espaço vira %20, um e comercial vira %26 e «ह» vira %E0%A4%B9.

Desenvolvedores precisam disso ao montar requisições de API, query strings, links de redirecionamento e callbacks do OAuth; profissionais de marketing precisam ao ler URLs longas de rastreamento; e todos, de vez em quando, precisam transformar um link ilegível cheio de códigos % de volta em texto simples. Esta ferramenta grátis codifica de três formas padrão — componente de URL, URL completa e dados de formulário — decodifica com mensagens de erro úteis e divide qualquer URL em partes, com uma tabela decodificada dos parâmetros da query.

Principais recursos

• Codificação de componente — encodeURIComponent estrito da RFC 3986 para valores de parâmetros e segmentos de caminho.
• Codificação de URL completa — o encodeURI mantém a estrutura da URL intacta.
• Codificação de formulário — espaços como +, como nos envios de formulários HTML.
• Decodificação nos três modos, com erros claros para sequências quebradas.
• Suporte completo a Unicode — hindi, outras escritas, emoji e símbolos de moeda via UTF-8.
• Detalhamento da URL — protocolo, host, porta, caminho e fragmento.
• Tabela de parâmetros da query com nomes e valores decodificados.
• Privado — roda localmente no seu navegador.

Como usar — passo a passo

1. Escolha Codificar ou Decodificar.
2. Selecione o tipo de codificação — Componente, URL completa ou Dados de formulário.
3. Cole seu texto ou URL; o resultado se atualiza na hora.
4. Copie o resultado ou pressione Usar o resultado como entrada para codificar ou decodificar de novo.
5. Veja o detalhamento para inspecionar o host, o caminho e os parâmetros.

Exemplos de codificação

Componente x URL completa x dados de formulário

O modo Componente codifica todos os caracteres, exceto o conjunto não reservado (A–Z, a–z, 0–9, - _ . ~). Use para uma única peça de uma URL: um termo de busca, um destino de redirecionamento dentro de um parâmetro, um nome de arquivo em um caminho. Nosso modo componente também codifica ! ' ( ) * para estar em estrita conformidade com a RFC 3986, o que algumas APIs e esquemas de assinatura (como o OAuth 1.0) exigem.

O modo URL completa deixa intactos os caracteres reservados que estruturam uma URL — : / ? # [ ] @ ! $ & ' ( ) * + , ; = — e codifica apenas espaços, caracteres não ASCII e alguns símbolos inseguros. Use para arrumar um endereço completo que alguém digitou com espaços ou palavras em hindi.

O modo Dados de formulário segue o application/x-www-form-urlencoded, o formato que os navegadores usam para envios de formulários HTML: como o modo componente, mas os espaços viram +. Ao decodificar dados de formulário, o + volta a ser um espaço.

Anatomia de uma URL

Veja https://shop.example.com:8443/products/shoes?color=red&size=9#reviews:

• Protocolo (esquema): https:
• Host: shop.example.com
• Porta: 8443 (omitida quando é a padrão, 443 para https)
• Caminho: /products/shoes
• Query string: color=red&size=9 — parâmetros separados por &
• Fragmento: reviews — tratado pelo navegador, não enviado ao servidor

O painel de detalhamento mostra essas partes para qualquer URL que você colar, usando o analisador de URL padrão do navegador, e decodifica cada parâmetro para que você leia valores como q=%E0%A4%B9… como texto em hindi.

Unicode e UTF-8

As URLs modernas carregam texto que não é do inglês convertendo cada caractere em seus bytes UTF-8 e codificando cada byte com porcentagem. Os caracteres devanágari ocupam três bytes, a maioria dos emoji ocupa quatro e o sinal de rúpia ₹ ocupa três — então ₹ vira %E2%82%B9. Os navegadores geralmente exibem os caracteres legíveis na barra de endereços (isso se chama IRI, identificador de recurso internacionalizado) enquanto enviam a forma codificada aos servidores. Os nomes de domínio são um caso à parte: usam Punycode (xn--…) em vez de codificação por porcentagem.

Codificação de URL em código

• JavaScript: encodeURIComponent(value), encodeURI(url), new URLSearchParams({ q: value }).toString() para o estilo de formulário.
• Python: urllib.parse.quote(value), quote_plus(value) para o estilo de formulário, unquote() para decodificar.
• PHP: rawurlencode() (RFC 3986) e urlencode() (estilo de formulário).
• Java: URLEncoder.encode(value, StandardCharsets.UTF_8) — estilo de formulário com +.

Quando os resultados do seu código e desta ferramenta diferem, confira qual estilo cada um usa — a diferença entre + e %20 é a maior fonte de confusão.

Exemplo resolvido: um link de pedido pelo WhatsApp

Pequenos negócios costumam compartilhar links que abrem o WhatsApp com uma mensagem pronta. O formato é https://wa.me/<number>?text=<message>, e a mensagem precisa ser codificada como componente. Para a mensagem «Hi! I want to order 2 kg आम & 1 dozen केले», esta ferramenta dá Hi%21%20I%20want%20to%20order%202%20kg%20%E0%A4%86%E0%A4%AE%20%26%201%20dozen%20%E0%A4%95%E0%A5%87%E0%A4%B2%E0%A5%87. Sem codificação, o & encerraria o parâmetro de texto mais cedo e o cliente veria apenas «Hi! I want to order 2 kg आम». Cole sua mensagem na ferramenta no modo Componente, copie o resultado e acrescente-o depois de ?text=. (A ferramenta também codifica ! como %21 para conformidade estrita com a RFC 3986; o encodeURIComponent simples o deixa como !, e ambos funcionam.)

Codificação e segurança

A codificação correta também é uma questão de segurança. Se a entrada do usuário é colocada em uma URL sem codificação, um valor contendo &, = ou # pode acrescentar ou sobrescrever parâmetros — um problema conhecido como injeção de parâmetros — e entradas sem escape em URLs de redirecionamento podem ser usadas em redirecionamentos abertos ou phishing. Sempre codifique cada valor separadamente com um codificador de componente (ou uma biblioteca como URLSearchParams), valide os destinos de redirecionamento contra uma lista de permissão e lembre-se de que codificar não é criptografar: qualquer um pode decodificar uma URL, então nunca coloque senhas nem segredos em query strings, onde acabam no histórico do navegador e nos logs do servidor.

Usos comuns

• Montar requisições de API e query strings com entrada do usuário.
• Codificar URLs de redirecionamento dentro de parâmetros de OAuth ou de login.
• Ler links longos de rastreamento ou de afiliados.
• Corrigir links que contêm espaços ou palavras em hindi.
• Preparar links «click to chat» do WhatsApp com mensagens pré-preenchidas.
• Depurar logs de servidores web cheios de códigos %.
• Criar links mailto: com assuntos e corpos codificados.
• Passar nomes de arquivos com espaços ou colchetes para URLs de download.
• Conferir exatamente o que um navegador vai enviar quando um link contém caracteres especiais.

Erros comuns a evitar

• Codificar uma URL inteira no modo componente — isso quebra o https:// e as barras.
• Não codificar valores de parâmetros — um & dentro de um valor o divide em dois parâmetros.
• Codificação dupla — %2520 em vez de %20.
• Usar + em caminhos — o + só significa um espaço em query strings codificadas como formulário.
• Esquecer o UTF-8 — sistemas antigos que usam outras codificações produzem códigos % diferentes.
• Decodificar entrada não confiável e inseri-la em HTML — decodifique e depois faça o escape de HTML antes de exibir, ou você corre o risco de cross-site scripting.

Solução de problemas

• «Não foi possível decodificar» — procure um % que não seja seguido de dois dígitos hexadecimais, como em «50% off»; codifique-o como %25 ou remova-o.
• Nenhum detalhamento exibido — o texto não é uma URL completa; inclua https://.
• Os sinais de mais permanecem após a decodificação — mude para o modo Dados de formulário.
• A saída difere de outra ferramenta em %21, %27, %28, %29 ou %2A — esta ferramenta codifica ! ' ( ) * de forma estrita; as duas formas decodificam para o mesmo texto.
• O hindi aparece como pontos de interrogação em outro lugar — o sistema receptor pode não decodificar UTF-8; confira as configurações de codificação dele.

Glossário rápido

• Codificação por porcentagem: representar um byte como % seguido de dois dígitos hexadecimais.
• Caracteres reservados: caracteres com significado especial em URLs, como / ? & = #.
• Caracteres não reservados: letras, dígitos e - _ . ~, que nunca precisam ser codificados.
• Query string: a parte depois de ? que contém os parâmetros chave=valor.
• Fragmento: a parte depois de #, usada dentro da página.
• RFC 3986: o padrão que define a sintaxe de URI.
• Punycode: a codificação xn-- usada para nomes de domínio que não são do inglês.
• Codificação dupla: codificar um texto que já estava codificado, produzindo sequências %25XX.

Por que usar este Codificador de URL?

Ele cobre os três estilos de codificação que os desenvolvedores realmente encontram, trata hindi e emoji corretamente, explica os erros com clareza e divide as URLs em partes legíveis — grátis, instantâneo e privado.

Codificador / decodificador de URL — Informações principais

Perguntas frequentes

Conheça mais ferramentas da Prompt Minds

O Codificador / decodificador de URL funciona muito bem junto com nossas outras ferramentas grátis. Todas as ferramentas do Prompt Minds rodam inteiramente no seu navegador — sem cadastro, sem uploads, sem marca d’água. Ver todas as ferramentas grátis.