O que é Decodificação de URL?

A decodificação de URL é o processo de converter caracteres codificados em uma string de URL de volta à sua forma original legível. Em uma URL, certos caracteres (como espaços ou símbolos especiais) são substituídos por valores com percent-encoding para garantir compatibilidade entre todos os navegadores e servidores.

Por exemplo:

https%3A%2F%2Fexample.com%2Ffile%20name

...se torna:

https://example.com/file name

Como Funciona a Decodificação de URL?

Quando uma URL é codificada, caracteres especiais são substituídos por sinais de porcentagem (%) seguidos de valores hexadecimais de dois dígitos. O decodificador lê a string, identifica essas sequências %xx e as converte de volta para seus equivalentes ASCII ou UTF-8.

Por exemplo:

• %20 = espaço ( )

• %3A = dois-pontos (:)

• %2F = barra (/)

Esse processo é realizado usando funções de decodificação padrão disponíveis em todas as principais linguagens de programação.

Como Usar o Decodificador de URL do Qodex

1. Cole sua URL com percent-encoding ou string codificada.

2. Clique em "Decodificar".

3. Obtenha o texto limpo e legível instantaneamente na caixa de saída.

4. Use "Copiar" ou baixe o resultado.

Esta ferramenta funciona inteiramente no seu navegador e suporta decodificação de URLs completas, query strings e fragmentos de texto codificados.

Tabela de Referência de Percent-Encoding

Abaixo está uma referência dos caracteres com percent-encoding mais encontrados em URLs, com base no RFC 3986:

Decodificação de URL em Diferentes Linguagens de Programação

Veja como decodificar URLs nas linguagens de programação mais populares:

JavaScript

// Decode a full URI (preserves special URI characters)
const decoded = decodeURI('https://example.com/path%20with%20spaces');
// Output: https://example.com/path with spaces
// Decode a URI component (decodes everything including :, /, ?)
const param = decodeURIComponent('hello%20world%26foo%3Dbar');
// Output: hello world&foo=bar

Python

from urllib.parse import unquote, unquote_plus
Decode percent-encoded URL
decoded = unquote('https%3A%2F%2Fexample.com%2Ffile%20name')
Output: https://example.com/file name
Decode form-encoded string (+ as space)
decoded_form = unquote_plus('hello+world%26foo%3Dbar')
Output: hello world&foo=bar

Java

import java.net.URLDecoder;
import java.nio.charset.StandardCharsets;
String encoded = "https%3A%2F%2Fexample.com%2Ffile%20name";
String decoded = URLDecoder.decode(encoded, StandardCharsets.UTF_8);
// Output: https://example.com/file name

PHP

// Decode percent-encoded string
$decoded = urldecode('https%3A%2F%2Fexample.com%2Ffile%20name');
// Output: https://example.com/file name
// Decode without converting + to space
$decoded_raw = rawurldecode('hello%20world%2B');
// Output: hello world+

Go

package main
import (
"fmt"
"net/url"
)
func main() {
decoded, err := url.QueryUnescape("https%3A%2F%2Fexample.com%2Ffile%20name")
if err != nil {
fmt.Println("Error:", err)
return
}
fmt.Println(decoded)
// Output: https://example.com/file name
}

Caracteres Reservados vs. Não Reservados em URLs (RFC 3986)

Entender quais caracteres são reservados e quais não são ajuda a explicar por que certos caracteres recebem percent-encoding em URLs.

Caracteres Não Reservados (nunca precisam de codificação)

Esses caracteres podem aparecer em qualquer parte de uma URL sem codificação:

A-Z  a-z  0-9  -  _  .  ~

Caracteres Reservados (têm significado especial em URLs)

Esses caracteres têm funções específicas na sintaxe de URL. Devem ser codificados com percent-encoding quando usados fora de sua finalidade pretendida:

Quando um caractere reservado aparece em um componente de URL onde não está servindo ao seu propósito reservado (por exemplo, um literal & no valor de um parâmetro de consulta), ele deve ser codificado como %26.

Casos de Uso Práticos

• Depuração de URLs: Inspecione rapidamente parâmetros de consulta complexos ou quebrados.

• Limpeza de Dados: Decodifique dados codificados de formulários, logs ou APIs.

• Desenvolvimento Web: Decodifique strings antes do processamento adicional em apps.

• Análise de SEO: Entenda URLs legíveis a partir de versões codificadas em relatórios de análise e rastreamento.

• Revisões de Segurança: Inspecione links suspeitos e entradas ofuscadas para possíveis ataques de injeção.

Ferramentas Relacionadas

• Codificador de URL - Codifique URLs para transmissão segura

• Decodificador UTF-8 - Decodifique texto com codificação UTF-8

• Decodificador Base64 - Decodifique conteúdo codificado em Base64

Dicas Profissionais

• URLs frequentemente contêm múltiplas codificações. Se você decodificar e ainda ver %, execute novamente.

• Não decodifique valores mais de uma vez, a menos que tenha certeza de que foram duplamente codificados.

• Use isso com nosso Codificador de URL para testes de ida e volta.

• Decodifique query strings para separar parâmetros para depuração ou análise.

• Em dados de formulário (application/x-www-form-urlencoded), + representa um espaço, não %20.