Codificador e decodificador de URL

Por que uma URL não pode simplesmente conter qualquer coisa

Uma URL tem gramática. O ponto de interrogação inicia a query, o E comercial separa os parâmetros, o sinal de igual associa um nome a um valor, a cerquilha pula para um fragmento — esses caracteres são estrutura, não conteúdo. Cole um valor que os contenha em forma bruta, e a URL muda de significado silenciosamente: procure por fish & chips sem codificar, e tudo depois do E comercial é lido como um parâmetro completamente novo, então o pobre servidor busca só por fish. A codificação percentual é a válvula de escape — cada byte problemático é escrito como um sinal de porcentagem mais dois dígitos hexadecimais, sendo %20 para um espaço o mais famoso. Letras acentuadas e emojis viram vários desses bytes cada um, e é por isso que texto fora do inglês vira sequências percentuais surpreendentemente longas. Isso é normal, não corrupção.

Decodificar: lendo o que um link realmente diz

O modo de decodificação se justifica em links feitos por outras pessoas. Links de newsletters e anúncios costumam embrulhar o destino real dentro de um parâmetro url= de algum rastreador de cliques — decodifique tudo, e o alvo real aparece em texto puro, algo que vale a pena fazer antes de confiar em um link desconhecido. É também a forma rápida de ler o que um formulário realmente enviou ou o que uma chamada de API realmente pediu. Um padrão para reconhecer: se o texto decodificado ainda contém sequências como %2520, o valor foi codificado duas vezes — decodifique mais uma vez e ele se resolve. A dupla codificação é igualmente o bug clássico na direção contrária, então, ao construir links, codifique cada valor exatamente uma vez, no último momento antes de montar a URL.

Construindo links à mão

O uso mais comum do lado de codificação é construir links fora de uma linguagem de programação — modelos de mala direta, fórmulas de planilha, macros de suporte, testes rápidos de API. A receita confiável: codifique cada valor separadamente e depois junte as partes com o ? & = literal você mesmo. É também por isso que o modo de valor escapa até barras — dentro de um valor, uma barra é só um caractere. Esta ferramenta é gratuita e sem limites, como todo o nosso conjunto de ferramentas para desenvolvedores. E uma dica para o que você encontra dentro de links decodificados: uma parede de letras e dígitos terminando em = geralmente é Base64 — cole no nosso decodificador de Base64 — e um valor longo com dois pontos no meio provavelmente é um token para o decodificador de JWT.

Dois tipos de codificação — escolha o certo

Codificar um valor escapa tudo o que tem significado especial em uma URL (incluindo / ? & =) — use para um trecho de texto avulso que vai entrar em uma query string, como um termo de busca. Codificar uma URL completa só escapa caracteres que não podem aparecer em uma URL de jeito nenhum (como espaços) e mantém intacta a estrutura da própria URL. Usar o modo errado é a causa clássica de links quebrados.