Codificar e decodificar URL online

Codificar uma URL (percent-encoding) troca os caracteres que não podem aparecer em uma URL, como espaços e acentos, por sequências no formato %XX. Esta ferramenta codifica e decodifica tanto um trecho, como o valor de um parâmetro, quanto uma URL completa, e roda no seu navegador.

Atualizado em · Por Leonardo Gaertner

A conversão é feita no seu navegador e o texto não é enviado a nenhum servidor.

Achou um resultado errado ou tem uma sugestão? Avise por e-mail.

Como usar

  1. Escolha Codificar ou Decodificar.
  2. Escolha Trecho (parâmetro) para o valor de um parâmetro ou URL completa para um endereço inteiro.
  3. Cole o texto no campo de entrada e copie o resultado.

Como funciona

Cada caractere fora do conjunto permitido é convertido para bytes UTF-8, e cada byte vira %XX em hexadecimal. Por isso o é de café vira %C3%A9, dois bytes, e o espaço vira %20.

No modo Trecho, os caracteres reservados também são codificados (como & ? = / # e +), o que é o certo para o valor de um parâmetro. No modo URL completa, esses caracteres são mantidos, para que o endereço continue funcionando.

Em formulários (application/x-www-form-urlencoded), o espaço costuma vir como +. Ao decodificar, marque Tratar + como espaço nesse caso. Na codificação padrão de URL, o + é um caractere comum.

Exemplo de trecho com acento e símbolos

Texto: café & pão

Codificado: caf%C3%A9%20%26%20p%C3%A3o

Fonte: RFC 3986: sintaxe de URI; MDN: encodeURIComponent()

Em código

Para codificar um valor de URL em código, use a função de componente (espaço vira %20). Para a query string inteira, use o montador da linguagem (espaço vira +).

JavaScript 
// Um valor dentro da URL (parâmetro, trecho do caminho): espaço vira %20
function codificarParametro(valor) {
  return encodeURIComponent(valor);
}

// A query string inteira, no formato de formulário: espaço vira +
function montarQuery(params) {
  return new URLSearchParams(params).toString();
}

// Ler a query string: o URLSearchParams entende tanto + quanto %20
function lerQuery(query) {
  return Object.fromEntries(new URLSearchParams(query));
}
Python 
from urllib.parse import parse_qsl, quote, urlencode


def codificar_parametro(valor: str) -> str:
    return quote(valor, safe="")  # espaço vira %20; sem safe="", a barra passaria


def montar_query(params: dict) -> str:
    return urlencode(params)  # espaço vira +


def ler_query(query: str) -> dict:
    return dict(parse_qsl(query, keep_blank_values=True))
PHP 
<?php
function codificarParametro(string $valor): string
{
    return rawurlencode($valor); // espaço vira %20
}

function montarQuery(array $params): string
{
    return http_build_query($params); // espaço vira +
}

function lerQuery(string $query): array
{
    parse_str($query, $params);
    return $params;
}

Perguntas frequentes

Qual a diferença entre codificar um trecho e uma URL completa?

Ao codificar um trecho, símbolos como / ? & = também são convertidos, para que o valor não interfira na estrutura da URL. Ao codificar uma URL completa, esses símbolos são preservados, senão o endereço deixaria de funcionar.

O espaço é %20 ou +?

Na URL propriamente dita, é %20. O + como espaço vale só em dados de formulário (application/x-www-form-urlencoded), como nos parâmetros de uma consulta enviada por um form.

Por que a decodificação dá erro?

Porque há um % sem os dois dígitos hexadecimais depois dele, ou uma sequência que não forma um caractere UTF-8 válido. Confira se o texto foi copiado por inteiro.

O que é codificar duas vezes?

É aplicar a codificação a um texto que já estava codificado, então o % vira %25 (por exemplo, %20 vira %2520). Se o resultado tem %25, provavelmente houve dupla codificação: decodifique uma vez.

Guias sobre este assunto

Outras ferramentas que podem ajudar

Ver tudo em Codificação e segurança