Codificador de URL Online

O que é Codificação de URL?

A codificação de URL (também chamada de codificação percentual) é um mecanismo para codificar informações em um Identificador de Recursos Uniforme (URI) de forma que apenas os caracteres permitidos pelo RFC 3986 apareçam na string final. Qualquer caractere que não seja um caractere não reservado (A–Z, a–z, 0–9, -, _, ., ~) é substituído por um sinal de percentual seguido de dois dígitos hexadecimais representando o valor do byte UTF-8 do caractere — por exemplo, um espaço se torna %20 e & se torna %26.

A codificação percentual é necessária porque as URLs só podem conter um conjunto limitado de caracteres ASCII. Quando uma URL inclui caracteres fora desse conjunto — espaços, letras Unicode, símbolos como &, = ou / usados como valores literais em vez de delimitadores estruturais — esses caracteres devem ser codificados para evitar que o parser de URL os interprete incorretamente. Isso é especialmente crítico para valores de query string, onde & ou = não codificados quebrariam a estrutura de parâmetros.

Por que usar esta ferramenta?

Veja instantaneamente como seu texto é codificado em ambos os modos, com uma comparação ao vivo lado a lado — sem necessidade de escrever código para verificar casos extremos.

Como usar este codificador de URL online

Sem conta, sem instalação. Cole ou digite seu texto no campo de entrada e o resultado codificado em percentual aparece instantaneamente. Tudo roda no seu navegador — seus dados nunca saem do seu dispositivo.

1. 1
   Cole seu texto ou URL

   Insira qualquer string — o valor de um parâmetro de consulta, uma URL completa, um segmento de caminho ou um payload JSON. O codificador processa caractere por caractere de acordo com o RFC 3986.
2. 2
   Escolha o modo de codificação

   Selecione encodeURIComponent para codificar valores de parâmetros individuais (codifica tudo exceto caracteres não reservados). Selecione encodeURI para codificar uma URL completa preservando seus caracteres estruturais como ://?#&=.
3. 3
   Copie a saída codificada

   A string codificada em percentual aparece instantaneamente. Clique em Copiar para pegar o resultado e colá-lo diretamente na sua chamada de API, ação de formulário ou arquivo de configuração.
4. 4
   Decodifique se necessário

   Cometeu um erro ou quer verificar o resultado? Alterne para a ferramenta Decodificador de URL com um clique para reverter a codificação.

Quais caracteres são codificados?

O RFC 3986 divide os caracteres de URL em duas categorias: caracteres não reservados (nunca codificados) e caracteres reservados (têm significado especial — codificados ou preservados dependendo do contexto). A tabela mostra como as duas funções JavaScript tratam os caracteres principais:

encodeURIComponent vs encodeURI

O JavaScript fornece duas funções de codificação com comportamentos muito diferentes. Escolher a errada é um dos bugs mais comuns no tratamento de URLs:

Casos de uso comuns

Exemplos de código

Como codificar strings de URL em linguagens e ambientes populares:

// Encode a query parameter value (most common case)
encodeURIComponent('hello world & more') // → "hello%20world%20%26%20more"

// Encode a complete URL (preserves ://?#& structure)
encodeURI('https://example.com/path?q=hello world') // → "https://example.com/path?q=hello%20world"

// Build a query string safely
const params = new URLSearchParams({ q: 'hello world', lang: 'en' })
const url = `https://example.com/search?${params}` // uses + for spaces

from urllib.parse import quote, urlencode, quote_plus

# Encode a path segment or query value
quote('hello world & more')          # → 'hello%20world%20%26%20more'

# Encode for application/x-www-form-urlencoded (space → +)
quote_plus('hello world')            # → 'hello+world'

# Build a query string
urlencode({'q': 'hello world', 'lang': 'en'})  # → 'q=hello+world&lang=en'

const url = new URL('https://example.com/search')
url.searchParams.set('q', 'hello world & more')
url.searchParams.set('lang', 'en')
console.log(url.toString())
// → https://example.com/search?q=hello+world+%26+more&lang=en

# curl automatically percent-encodes --data fields
curl -G "https://example.com/search" --data-urlencode "q=hello world & more"

# Manual encoding with Python one-liner
python3 -c "from urllib.parse import quote; print(quote('hello world'))"

Codificador de URL vs. alternativas

Várias ferramentas podem codificar texto em percentual, mas diferem em controle, privacidade e contexto.

Perguntas frequentes