Construtor de Query String

Adicione pares de chave/valor e uma URL base e construa na hora uma query string corretamente codificada e a URL completa — com codificação de URL adequada, descarte de chaves vazias e cópia, tudo no seu navegador.

Parâmetros 

    

    

      
      
    

  



    

    

      
O Construtor de Query String da ToolsSoup é uma ferramenta online gratuita que transforma uma lista de pares de chave/valor em uma query string corretamente codificada — e em uma URL completa quando você adiciona uma base. Digite o nome e o valor de cada parâmetro na sua própria linha, adicione ou remova linhas conforme avança, e a query string codificada se atualiza ao vivo. Chaves e valores são codificados com a mesma lógica de URLSearchParams que os navegadores usam, então espaços, e-comerciais e outros caracteres especiais são escapados com segurança. Tudo roda localmente no seu navegador, então nada que você digita é enviado para um servidor. É exatamente o inverso do nosso Analisador de Query String.

      

        
O que é um construtor de query string?

        
Uma query string é a parte da URL depois do ponto de interrogação, formada por pares nome=valor unidos por e-comerciais — por exemplo ?pagina=2&ordem=preco&tag=novo. Montar uma à mão é propenso a erros, porque cada caractere especial em uma chave ou valor precisa ser codificado: um espaço vira %20, um e-comercial vira %26 e assim por diante. Um construtor de query string pega pares simples de chave/valor e faz essa codificação para você, produzindo uma string segura para colocar diretamente em uma URL. Esta ferramenta usa o URLSearchParams nativo do navegador, então a saída corresponde exatamente ao que a própria plataforma geraria.

        
      

      

        
Como construir uma query string

        
Montar uma query string leva só alguns segundos:

        
  1. Digite o nome e o valor de um parâmetro na primeira linha e clique em Adicionar parâmetro para cada par extra.
  2. Opcionalmente, cole uma URL base para obter um link completo e pronto para uso em vez de apenas a query string.
  3. Copie o resultado codificado — linhas com chave vazia são ignoradas automaticamente.

      

      

        
Codificação, chaves vazias e a URL base

        
Cada chave e valor é codificado individualmente, então você pode digitar caracteres como espaços, =, & ou # sem quebrar a URL. Linhas sem chave são ignoradas, o que permite manter linhas em branco enquanto você trabalha sem poluir a saída. Quando você fornece uma URL base, o construtor anexa a consulta com um ? se a base ainda não tiver nenhuma, ou com um & se ela já contiver uma query string. Sem uma base, você pode ativar ou desativar o ponto de interrogação inicial dependendo de querer um ?a=1&b=2 isolado ou um a=1&b=2 simples.

        
      

      

        
Por que usar este construtor de query string?

        
  • Codifica cada chave e valor com o URLSearchParams nativo do navegador para uma saída correta e segura.
  • Adicione e remova linhas de parâmetro livremente, com um campo limpo de chave/valor para cada par.
  • Opcionalmente combine seus parâmetros com uma URL base para obter um link completo e pronto para uso.
  • Ignora linhas com chaves vazias e permite adicionar ou omitir o ponto de interrogação inicial.
  • Roda 100% no seu navegador, então valores com tokens ou dados pessoais nunca saem do seu dispositivo.

      

      

        
Perguntas frequentes

        

          
Como os caracteres especiais são tratados?

          
Cada chave e valor é codificado separadamente usando URLSearchParams, o mesmo codificador que os navegadores usam. Espaços viram %20 (ou + em alguns contextos), e-comerciais viram %26 e outros caracteres reservados são escapados, então a query string é sempre segura para colocar em uma URL.

        

        

          
Posso repetir a mesma chave?

          
Sim. Adicione duas linhas com o mesmo nome — por exemplo tag e tag — e ambas aparecem na saída como tag=a&tag=b. Repetir uma chave é a forma padrão de codificar arrays e filtros de seleção múltipla em uma query string.

        

        

          
O que acontece com linhas vazias?

          
Linhas com chave vazia são ignoradas, então você pode deixar uma linha em branco enquanto constrói o resto. Uma linha com chave preenchida mas valor vazio é mantida e produz chave= na saída.

        

        

          
Algo que eu digito é enviado para algum lugar?

          
Não. Toda a codificação acontece localmente no seu navegador com JavaScript. As chaves, valores e a URL base que você digita e o resultado nunca saem do seu dispositivo, então é seguro construir URLs que contêm tokens ou outros dados privados.