Pular para o conteúdo
SPCXTools

Codificar e Decodificar URL

Codifique texto para URLs (percent-encoding) ou decodifique URLs e query strings de volta para texto legível.

Roda localmente — os arquivos não saem do seu dispositivo

Carregando ferramenta…

Como usar: Codificar e Decodificar URL

  1. 1Selecione Codificar para tornar o texto seguro para uma URL, ou Decodificar para converter sequências do tipo %20 de volta para texto.
  2. 2Escolha Componente para um único valor de parâmetro ou segmento de caminho, ou URL Completa para manter caracteres como /, ? e & intactos.
  3. 3Marque Espaços como + ao trabalhar com dados de formulários HTML (application/x-www-form-urlencoded).
  4. 4Cole seu texto — o resultado aparece imediatamente. No modo de decodificação, os parâmetros de consulta são listados em uma tabela.
  5. 5Copie o resultado com um clique.

Codifique e decodifique URLs com segurança

URLs podem conter apenas um conjunto limitado de caracteres. Espaços, letras acentuadas, emojis e símbolos como &, = ou # devem ser codificados com percent-encoding — escritos como % seguido por dois dígitos hexadecimais — antes de poderem aparecer dentro de uma URL. Esta ferramenta converte texto para esse formato e vice-versa. Ela roda no seu navegador, então as URLs que você cola, incluindo quaisquer tokens ou dados pessoais que elas contenham, nunca são enviadas para um servidor.

Recursos

  • Dois escopos de codificação: codifique um único valor (componente) ou uma URL inteira, preservando sua estrutura.
  • Codificação estilo formulário: opcionalmente, escreva espaços como + e decodifique + de volta para espaços.
  • Suporte a UTF-8 para todos os idiomas e emojis.
  • Visualizador de query string: ao decodificar uma URL, cada parâmetro é exibido como um par chave/valor, facilitando a leitura de links de rastreamento longos e chamadas de API.
  • Resultado instantâneo com cópia em um clique, e uma troca de modo que move o resultado para a entrada para uma conversão rápida de ida e volta.

Quando você precisa de codificação de URL

Construindo requisições de API. Se um termo de busca ou valor de filtro contém espaços ou símbolos, ele deve ser codificado antes de ser adicionado a uma query string. Caso contrário, & ou = dentro do valor seriam interpretados como o início de um novo parâmetro.

Lendo links de rastreamento e redirecionamento. Links de marketing e redirecionamentos de login frequentemente contêm uma URL inteira codificada dentro de outra. Decodifique-os para ver para onde um link realmente leva e quais parâmetros ele carrega.

Depurando formulários web. Envios de formulários codificam campos como pares key=value unidos por &, com espaços como +. Decodificar o corpo bruto (raw body) mostra exatamente o que foi enviado.

Compartilhando links com texto não-inglês. Navegadores exibem https://example.com/東京 de forma amigável, mas a requisição real usa %E6%9D%B1%E4%BA%AC. A codificação mostra a forma que os servidores recebem.

Caracteres reservados e não reservados

A RFC 3986 define os caracteres não reservados que nunca precisam de codificação: letras, dígitos, -, ., _ e ~. Os caracteres reservados — : / ? # [ ] @ ! $ & ' ( ) * + , ; = — têm significado especial em URLs e devem ser codificados quando aparecem dentro de um valor. Todo o resto, incluindo espaços e todos os caracteres não-ASCII, é sempre codificado.

A codificação de URL é diferente de Base64. Se você precisa transportar dados binários ou quer uma representação compacta apenas com letras e números, use o codificador Base64 — no modo Base64URL, o resultado é seguro para ser colocado diretamente em uma URL.

Perguntas frequentes

Qual é a diferença entre o modo Componente e URL Completa?
Componente codifica todos os caracteres que têm um significado especial em URLs, incluindo / ? & = #. Use-o para valores de consulta individuais. URL Completa deixa esses caracteres estruturais intactos e codifica apenas o que é inválido, como espaços e letras não-ASCII, para que uma URL completa permaneça funcional.
Por que os espaços às vezes são %20 e outras vezes +?
No caminho (path) e na maioria das APIs modernas, um espaço é codificado como %20. Formulários HTML enviados com o tipo de conteúdo padrão codificam espaços como + na query string. Ambos são comuns; marque Espaços como + para corresponder à codificação de formulário.
Por que recebo um erro ao decodificar?
A decodificação falha quando um % não é seguido por dois dígitos hexadecimais, ou quando os bytes não formam um UTF-8 válido. Isso geralmente acontece se o texto foi apenas parcialmente codificado ou foi codificado duas vezes. Verifique se há sinais de % perdidos.
Como os caracteres não-ingleses são codificados?
Eles são primeiro convertidos para bytes UTF-8, e cada byte se torna %XX. Por exemplo, "é" se torna %C3%A9 e "東" se torna %E6%9D%B1.
Meus dados são enviados para algum lugar?
Não. A codificação e decodificação usam funções nativas do navegador e rodam inteiramente no seu dispositivo.