Um fluxo de trabalho completo: de link colado a JSON documentado
Imagina um cenário hipotético de apoio técnico: um colega envia-te um link de um relatório de erro capturado no navegador de um utilizador, algo como https://painel.exemplo.com/relatorio?id=884&vista=detalhe&utm_source=email&utm_campaign=boletim_julho&fbclid=IwAR7zk. Precisas de perceber rapidamente o que este link realmente contém antes de o reencaminhares para a equipa de desenvolvimento.
Passo 1 — Analisar Query. Cola o URL completo no separador "Analisar Query". A tabela de resultados mostra de imediato cada parâmetro já descodificado, e assinala a laranja os que são de tracking (neste exemplo, utm_source, utm_campaign e fbclid). Os parâmetros funcionais — id e vista — ficam claramente distintos dos de marketing.
Passo 2 — Limpador de URL. Com a distinção já feita visualmente, cola o mesmo link na mini-ferramenta "Limpador de URL", mais abaixo na página. Com um clique obténs a versão sem os parâmetros de tracking — pronta para reencaminhar à equipa técnica sem ruído nem dados de campanha desnecessários.
Passo 3 — Query String → JSON. Se precisares de documentar este caso (por exemplo, num ticket ou numa nota interna), cola o link limpo na mini-ferramenta "Query String → JSON". O resultado é um pequeno objeto como {"id": "884", "vista": "detalhe"}, pronto a colar diretamente na descrição do ticket ou num ficheiro de caso de teste, sem teres de escrever esse JSON à mão.
Qual mini-ferramenta usar em cada situação — tabela de decisão
Com seis modos no separador principal e três mini-ferramentas adicionais, é fácil hesitar sobre por onde começar. Esta tabela resume qual escolher consoante o objetivo:
| Situação | Ferramenta/modo a usar |
|---|---|
| Tenho um único valor de texto para pôr num parâmetro | Separador "Codificar" — modo Componente |
| Tenho um endereço inteiro com espaços/acentos a preservar | Separador "Codificar" — modo URI completo |
| Recebi um link e quero perceber os parâmetros | Separador "Analisar Query" |
| Quero montar um link com vários parâmetros sem erros de sintaxe | Separador "Construir Query" |
| Quero decompor protocolo, anfitrião, caminho e fragmento | Separador "Analisar URL" |
| Tenho dezenas de valores/links para processar de uma vez | Separador "Massa" |
| Preciso de gerar ou ler um token/payload em Base64 | Mini-ferramenta "Base64" |
| Quero um link para documentação, sem os parâmetros de tracking | Mini-ferramenta "Limpador de URL" |
| Quero estruturar os parâmetros como objeto para um script ou nota | Mini-ferramenta "Query String → JSON" |
Repara que várias destas situações se encadeiam naturalmente — a análise de um URL leva quase sempre a uma limpeza ou a uma conversão para JSON, como no cenário do passo anterior.
A ordem importa: Base64 primeiro, codificação URL depois
Um caso hipotético de comparação: imagina que queres colocar num link um pequeno identificador de estado, como modo=avançado&nível=3, mas de forma compacta. Convertes primeiro esse texto na mini-ferramenta Base64 e obténs algo como bW9kbz1hdmFuw6dhZG8mbsOtdmVsPTM= (exemplo ilustrativo). Este resultado contém um sinal de igual "=" no final, que é um carácter normal em Base64 mas tem significado próprio numa query string.
Por isso, o passo seguinte é colar esse resultado Base64 no separador "Codificar" (modo Componente) antes de o inserires no link. Se fizeres o inverso — codificar o texto original para URL e só depois converter para Base64 — obténs uma cadeia diferente, que a maioria dos sistemas do lado do servidor não vai reconhecer como o payload original.
Levar a ferramenta para outra página sem a reconstruir
Além do fluxo de trabalho pessoal, esta ferramenta também está pensada para ser incorporada noutro sítio. Na secção "Adiciona esta ferramenta ao teu site", encontras um código de iframe já preenchido, que carrega uma vista simplificada da ferramenta — sem cabeçalho, menus nem secções de conteúdo, apenas os separadores de conversão.
Isto é útil, por exemplo, para uma página de documentação técnica interna de uma equipa que queira que os colegas testem a codificação de um parâmetro sem sair da própria página da wiki, ou para um artigo de apoio ao cliente que precise de um mini-conversor embutido junto às instruções. Basta copiar o código gerado e colá-lo no HTML de destino; a ligação de volta a esta página mantém-se sempre visível na vista incorporada.