URL decode: decodificador de URL (percent-encoding)

Como decodificar uma URL

1. Cole o texto codificado em URL ou texto codificado.
2. Deixe Tratar + como espaço ligado para query strings e dados de formulário, e desligue para caminhos ou valores em Base64.
3. Se o resultado ainda tiver sequências %XX, o status avisa: marque Decodificar repetidamente.
4. Para um arquivo de log ou uma coluna de valores, marque Cada linha separadamente para que cada linha seja decodificada isoladamente.
5. Escolha um Charset se a origem não era UTF-8 e depois clique em Copiar saída.

Quando a entrada é uma URL completa, a tabela abaixo dos painéis mostra o esquema, o host, o caminho decodificado, cada parâmetro de query em sua própria linha e o fragmento. É o jeito mais rápido de ler uma URL longa de rastreamento ou de redirecionamento.

Exemplos

Codificação dupla

Toda vez que uma string já codificada é codificada de novo, cada % vira %25. Assim, / vira %2F, depois %252F, depois %25252F. Isso acontece quando uma URL de redirecionamento passa por vários serviços, ou quando um framework codifica um valor que o código já tinha codificado.

Para ler uma string assim, decodifique até não sobrar nenhum escape; Decodificar repetidamente faz isso e informa o número de rodadas. Para corrigir a causa, encontre a camada que codifica uma segunda vez. Uma URL aninhada de propósito, como um parâmetro next= ou url= que contém outra URL, precisa de exatamente uma camada extra, e não mais.

Gateways de segurança de e-mail são uma fonte comum desse aninhamento. Uma URL do Microsoft Defender Safe Links tem a cara de https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fexample.com%2Freset%3Fid%3D42&data=…; cole-a e a tabela de parâmetros mostra o destino real, https://example.com/reset?id=42, sem que você precise clicar em nada.

Escapes malformados e charsets legados

Um % precisa ser seguido de exatamente dois dígitos hex. 100%, %zz ou uma URL cortada no meio de um escape é um erro, e o decodificador mostra Escape quebrado na posição N. O decodeURIComponent do JavaScript lança URIError: URI malformed nos mesmos casos, enquanto o unquote do Python deixa a sequência como está.

A outra fonte de erros é o charset. Escapes percentuais são bytes, e %E9 sozinho não é UTF-8 válido. O Python o decodifica como o caractere de substituição, o JavaScript lança um erro. Com o Charset em Windows-1252 ou ISO-8859-1, ele vira é. Shift_JIS, GBK, EUC-KR, KOI8-R e outros charsets legados estão na mesma lista.

Decodificar URL no código

decodeURIComponent("a%20b%26c")                   // "a b&c"
new URLSearchParams("q=a+b%2Bc").get("q")          // "a b+c"

from urllib.parse import unquote, unquote_plus, parse_qs
unquote("caf%C3%A9")                     # 'café'
unquote("caf%E9", encoding="latin-1")    # 'café'
unquote_plus("q=a+b%2Bc")                # 'q=a b+c'
parse_qs("q=a+b%2Bc&tag=x&tag=y")        # {'q': ['a b+c'], 'tag': ['x', 'y']}

O decodeURIComponent não transforma + em espaço; URLSearchParams e unquote_plus transformam. Escolha a função que corresponde a como a string foi gerada. Para codificar, veja o codificador de URL, e para Base64 que chegou por uma URL, o decodificador Base64URL.

Perguntas frequentes