Construtor de Query String

O Construtor de Query String ajuda você a criar e inspecionar a parte de uma URL que vem após o ponto de interrogação. Ele foi desenvolvido para desenvolvedores, profissionais de marketing, analistas, testadores de QA e equipes de suporte que precisam de parâmetros de URL limpos para páginas de busca, chamadas de API, redirecionamentos, URLs assinadas, campanhas UTM e tickets de depuração.

Como Usar o Construtor de Query String

1. Escolha o modo Construir quando tiver pares chave-valor, ou o modo Decodificar quando já tiver uma query string ou URL.
2. No modo Construir, insira um par chave-valor por linha. No modo Decodificar, cole uma query string bruta ou uma URL completa.
3. Escolha se os espaços devem se tornar sinais de mais ou espaços codificados por porcentagem, e escolha como as chaves repetidas devem ser representadas.
4. Clique em Construir Query String ou Decodificar Query String para gerar a query codificada, tabela decodificada, avisos e a pré-visualização em JSON.
5. Copie a query string, a versão com ponto de interrogação, a URL completa ou a representação em JSON para usar em códigos, análises, APIs ou redirecionamentos.

Notas sobre Codificação

As query strings são compactas, mas pequenas escolhas de codificação importam. Um espaço pode ser escrito como + na codificação de formulário clássica ou como %20 na codificação por porcentagem estrita. Caracteres reservados como &, =, ?, # e caracteres não-ASCII devem ser codificados por porcentagem quando representarem dados e não a estrutura da URL.

Usos Comuns

• Criar URLs de campanha UTM sem deixar cair nenhum parâmetro acidentalmente.
• Depurar requisições de API que usam filtros repetidos como tag=python&tag=web.
• Decodificar URLs de redirecionamento, escopos de OAuth, filtros de busca e tags de análise (analytics).
• Comparar uma query string bruta com uma query string normalizada antes de copiá-la para o código.

FAQ

O que é uma query string de URL?
Uma query string de URL é a parte de uma URL que vem após o ponto de interrogação. Ela armazena parâmetros como pares chave-valor, tais como q=url+tools&page=2, para que navegadores, servidores, APIs e ferramentas de análise possam passar pequenos fragmentos de estado.

Os espaços devem ser codificados como + ou %20?
Use sinais de mais para query strings clássicas de formulários HTML e muitos parâmetros de aplicações web. Use %20 quando precisar de codificação por porcentagem estrita, URLs assinadas, canonicalização de API ou um estilo que corresponda mais fielmente à RFC 3986.

Como as chaves de query repetidas são tratadas?
Chaves repetidas podem ser mantidas como tag=one&tag=two, convertidas em arrays de colchetes como tag[]=one&tag[]=two, ou convertidas em arrays indexados como tag[0]=one&tag[1]=two. Diferentes frameworks de back-end preferem convenções distintas.

Posso colar uma URL completa no decodificador?
Sim. O decodificador extrai a parte após o primeiro ponto de interrogação, ignora o fragmento após # para a decodificação e mostra a query string normalizada e os parâmetros decodificados.

Esta ferramenta envia requisições para a URL que eu inserir?
Não. A ferramenta apenas constrói, decodifica e exibe texto. Ela não visita a URL inserida, não chama um endpoint de API nem valida se um servidor remoto aceita os parâmetros.

Por que parâmetros de query duplicados e vazios importam?
Chaves duplicadas e valores vazios podem mudar a forma como um servidor interpreta uma requisição. Alguns frameworks transformam duplicatas em arrays, alguns mantêm apenas o primeiro ou o último valor, e alguns tratam valores vazios de forma diferente de parâmetros ausentes.