PT

Codificador / Descodificador URL

O que é a codificação URL?

A codificação URL (oficialmente percent-encoding, definida no RFC 3986) converte caracteres que são inseguros ou reservados em URLs em um % seguido de dois dígitos hexadecimais. Um espaço se torna %20, & se torna %26, = se torna %3D e ? se torna %3F. Isso garante que as URLs permaneçam estruturalmente válidas quando contêm caracteres especiais em parâmetros de consulta, segmentos de caminho ou identificadores de fragmento. Todos os caracteres exceto os não-reservados (letras, dígitos, -, _, ., ~) devem ser percent-encoded em URLs padrão.

A codificação URL é essencial ao construir requisições de API, analisar query strings, criar URLs de redirecionamento e tratar conteúdo enviado por usuários em aplicações web. Um erro comum é incorporar caracteres especiais brutos em URLs: um & dentro do valor de um parâmetro de consulta é interpretado como separador de parâmetros, corrompendo a estrutura da URL. Consultas de busca, tokens, nomes de arquivo com espaços e qualquer texto gerado pelo usuário devem ser codificados corretamente antes de serem inseridos em uma URL. A decodificação URL é igualmente útil ao ler valores codificados em arquivos de log ou respostas de API.

Esta ferramenta usa as funções compatíveis com RFC 3986 encodeURIComponent / decodeURIComponent, que codificam todos os caracteres exceto A–Z, a–z, 0–9, -, _, ., e ~. Observação: encodeURIComponent também codifica barras (/), portanto é projetado para codificar valores individuais de parâmetros de consulta, não URLs inteiras. Para codificar uma URL completa preservando sua estrutura, use encodeURI — que preserva caracteres estruturais como :, /, ? e #. Todo o processamento é feito localmente no seu navegador.

Perguntas Frequentes

O que é a codificação URL?
A codificação URL (percent-encoding) converte caracteres inseguros em um % seguido de dois dígitos hexadecimais. Por exemplo, um espaço se torna %20, & se torna %26 e = se torna %3D, mantendo as URLs estruturalmente válidas.
Por que preciso codificar um valor de URL?
URLs permitem apenas um conjunto limitado de caracteres. Se um parâmetro de consulta contém &, =, ?, # ou espaços, esses caracteres precisam ser codificados antes de serem inseridos na URL — caso contrário quebram a estrutura da URL e corrompem os dados.
Como decodifico uma URL percent-encoded?
Cole a URL ou o valor codificado no campo de entrada e selecione Descodificar. A ferramenta converte todas as sequências %XX de volta aos seus caracteres originais legíveis.
Quais caracteres são codificados por esta ferramenta?
Todos os caracteres exceto letras (A–Z, a–z), dígitos (0–9), hífen (-), sublinhado (_), ponto (.) e til (~) são codificados. Esses são os caracteres não-reservados definidos no RFC 3986 que são sempre seguros em URLs.
Qual é a diferença entre %20 e + para espaços?
%20 é a codificação percentual padrão para um espaço (RFC 3986). O sinal + representa um espaço apenas no formato application/x-www-form-urlencoded (envios de formulários HTML). Em URLs e APIs modernas, %20 é preferido e não ambíguo.
Como codifico o valor de um parâmetro de URL?
Codifique apenas o valor do parâmetro, não a URL inteira. Por exemplo, se o valor é "olá mundo", codifique para "ol%C3%A1%20mundo" e adicione à URL. Codificar a URL completa também codificaria o :// e as barras estruturais.
O que significa %3D em uma URL?
%3D é a forma percent-encoded do caractere =. Como = separa nomes de parâmetros de valores em query strings (chave=valor), qualquer = que apareça dentro do valor de um parâmetro deve ser codificado como %3D para evitar ambiguidade.