URL Encoder & Decoder – codifique e decodifique URLs online

Poucos caracteres são permitidos em uma URL. Todos os outros são representados por % seguido de dois dígitos hexadecimais para cada byte do caractere em UTF-8. Um espaço vira %20, “ä” vira %C3%A4 (dois bytes), “€” vira %E2%82%AC (três bytes) e um emoji como 😀 vira %F0%9F%98%80 (quatro bytes). Esse processo também é chamado de codificação percentual ou URL Encoding; entre desenvolvedores, costuma ser chamado de URL Encode, e o processo inverso, de URL Decode.

%20 é um espaço codificado: 20 é o valor hexadecimal do espaço. Da mesma forma, %3D representa =, %26 representa &, %2F representa / e %2C representa uma vírgula. %20 vale em qualquer parte de uma URL. O uso de + para representar um espaço ocorre apenas no formato de formulário (application/x-www-form-urlencoded), ou seja, em strings de consulta geradas por um formulário HTML. No caminho, + é um sinal de adição de verdade. “Käse & Brot” vira “K%C3%A4se+%26+Brot” como valor de formulário e “K%C3%A4se%20%26%20Brot” com encodeURIComponent. Por isso, ao decodificar dados de formulários e pesquisas, escolha “Formulário”.

encodeURI preserva os separadores de uma URL: ; , / ? : @ & = + $ #. encodeURIComponent também os codifica. Com encodeURI, “a/b?c=d” continua “a/b?c=d”; com encodeURIComponent, vira “a%2Fb%3Fc%3Dd”. Para um endereço completo, use encodeURI. Para um valor individual inserido em uma URL, use encodeURIComponent; caso contrário, um & ou = no valor pode separar os parâmetros incorretamente.

Escolha “Decodificar” e cole acima a URL ou o texto codificado. “M%C3%BCller%20%26%20S%C3%B6hne” vira “Müller & Söhne”. Se for uma URL, a ferramenta também separa o endereço em componentes como esquema, host, caminho, consulta e fragmento e mostra os parâmetros de consulta em uma tabela com nome, valor decodificado e valor original — por exemplo, q = tomates verdes em vez de gr%C3%BCne%20Tomaten. Os parâmetros ficam após ?, o nome e o valor são separados por = e os parâmetros entre si por &. Para dados de um formulário ou de uma pesquisa, escolha a variante “Formulário” para que + também seja interpretado como espaço no resultado.

As letras de A a Z e de a a z, os dígitos de 0 a 9 e os caracteres -_.~ permanecem inalterados; apenas o formato de formulário codifica o til como %7E. Os delimitadores : / ? # [ ] @ ! $ & ' ( ) * + , ; = só são permitidos em suas funções específicas, como & entre dois parâmetros. Espaços, aspas, %, < > ^ { | } e todos os caracteres fora de ASCII, como letras acentuadas e emojis, precisam ser codificados. encodeURIComponent também deixa ! * ' ( ) inalterados; a variante estrita conforme a RFC 3986 codifica esses caracteres. A tabela de caracteres acima mostra o resultado para os caracteres especiais mais comuns.

Você não os escreve diretamente: eles são codificados. Letras como “ä”, “ß”, “é”, “ñ” e “å” ocupam dois bytes cada em UTF-8: “ä” vira %C3%A4, “ß” vira %C3%9F, “é” vira %C3%A9, “ñ” vira %C3%B1 e “å” vira %C3%A5. Um espaço vira %20 ou, em formulários, +. Navegadores costumam exibir o endereço de forma legível e só codificá-lo no envio. Em links que você escreve, codifique o valor com encodeURIComponent ou com esta ferramenta; a tabela “O que acontece com seus caracteres” mostra o código Unicode e os bytes dos caracteres substituídos. Caracteres especiais em nomes de domínio não são codificados com %, mas convertidos por Punycode (müller.de vira xn--mller-kva.de). Esta ferramenta não faz essa conversão.

Se um texto já codificado for codificado novamente, o % se torna %25: «%20» vira «%2520». Você pode identificar isso pelo %25 seguido de dois dígitos e pela presença de sequências %XX no resultado após a decodificação. A ferramenta avisa e oferece a opção «Decodificar novamente». Para evitar isso, codifique cada valor exatamente uma vez, somente ao montar a URL.

Hoje, UTF-8 é o padrão: nele, “ä” = %C3%A4. Sites e sistemas antigos, porém, usam ISO-8859-1 (Latin-1), em que “ä” = %E4 e “é” = %E9. Um %E4 isolado é inválido em UTF-8: a ferramenta informa a posição e oferece a opção “Usar ISO-8859-1”. Com esse conjunto de caracteres, “K%E4se” volta a ser “Käse”. Caracteres inexistentes em ISO-8859-1, como “€”, não podem ser codificados dessa forma; para isso, volte a usar UTF-8.

Não. A codificação e a decodificação acontecem no seu navegador; seu texto não é enviado nem armazenado. Isso também vale para URLs com tokens ou credenciais. A ferramenta é gratuita e não exige cadastro.