Ir para o conteúdo principal
Bethemesh
Web e SEO

Analisador e gerador de query string

Analise parâmetros de URL ou gere uma cadeia de consulta. O processamento permanece local no navegador.

  • Área de transferência
Automatizar

Integrar este widget

Personalize o resultado, verifique a pré-visualização e copie o código.

Pré-visualização

Tipo de código de integração

Código a copiar

Responsivo e redimensionado automaticamente pela Bethemesh.

Esta ferramenta foi útil?

Como funciona esta ferramenta?

Esta ferramenta converte nos dois sentidos uma query string (a parte de um URL depois do ?) e um objeto JSON legível. No modo Analisar separa os parâmetros e descodifica os seus valores; no modo Gerar transforma um objeto JSON numa cadeia corretamente codificada, pronta a acrescentar a um URL.

No modo Analisar, se a entrada tiver um ?, só é lida a parte que se segue: pode colar um URL completo. Cada par chave=valor é separado por & e descodificado segundo as regras dos formulários web, em que + vale um espaço.

O resultado é um objeto JSON indentado. Um parâmetro que aparece várias vezes passa a ser um array que guarda todos os valores por ordem; a âncora (#secao) de um URL colado é ignorada.

No modo Gerar, a entrada tem de ser um objeto JSON. Cada propriedade passa a um par chave=valor; os espaços são escritos +, os carateres especiais codificados como %XX, pela ordem das propriedades.

Um JSON mal formado no modo Gerar produz um erro: verifique as aspas duplas à volta das chaves e dos valores.

Como usar esta ferramenta

  1. Escolha o modo

    Analisar para passar de um URL a JSON, Gerar para o inverso.

  2. Cole a entrada

    Um URL ou uma query string no modo Analisar, um objeto JSON no modo Gerar.

  3. Processe

    Clique em Processar para obter o resultado.

  4. Reutilize o resultado

    Copie o JSON ou acrescente a cadeia gerada depois do ? do seu URL.

Casos de uso

Ler um URL de rastreio

Separar um URL publicitário cheio de parâmetros utm_, gclid ou fbclid para ver cada valor.

Preparar uma chamada a uma API

Escrever os parâmetros de um pedido GET em JSON e obter a cadeia codificada.

Comparar dois URL

Analisar duas query strings para encontrar o parâmetro que muda.

Exemplos

Analisar um URL de pesquisa

O + passa a espaço. O parâmetro color aparece duas vezes: os dois valores, bleu e vert, ficam guardados num array.

Entrada

Modo: Analisar
Entrada: https://example.com/search?q=gourde+inox&color=bleu&color=vert&page=2

Resultado

Resultado:
{
  "q": "gourde inox",
  "color": [
    "bleu",
    "vert"
  ],
  "page": "2"
}

Gerar uma query string

Os espaços passam a + e os parâmetros mantêm a ordem do objeto JSON.

Entrada

Modo: Gerar
Entrada: {"q":"gourde inox","page":"2","tri":"prix croissant"}

Resultado

Resultado: q=gourde+inox&page=2&tri=prix+croissant

Dicas e boas práticas

  • Os parâmetros repetidos (color=azul&color=verde) passam a um array ["azul","verde"]: no modo Gerar esse array devolve os dois pares, por isso a ida e volta não perde nada.
  • No modo Gerar, todos os valores passam a texto: o número 2 escreve-se 2 e um array ["a","b"] produz um par por valor (chave=a&chave=b).
  • A âncora (#secao) de um URL colado no modo Analisar nunca é enviada ao servidor: é removida antes da análise.
  • Para codificar um só valor e não uma cadeia inteira, use o codificador de URL.

Fontes e referências

Perguntas frequentes

Porque é que o + é substituído por um espaço?

As query strings seguem o formato application/x-www-form-urlencoded, em que + representa um espaço. Um + literal tem de ser escrito %2B.

O que acontece aos parâmetros duplicados?

São agrupados num array, por ordem de aparição: color=azul&color=verde dá "color": ["azul","verde"]. Os filtros múltiplos de uma loja online ficam assim conservados.

Posso colar um URL completo?

Sim, no modo Analisar. Tudo o que vem antes do primeiro ? é ignorado e só a query string é separada.

Que formato espera o modo Gerar?

Um objeto JSON simples, por exemplo {"q":"garrafa","page":"2"}. Um objeto aninhado não é achatado: passa ao texto [object Object], inutilizável.

Os meus dados são enviados para um servidor?

Não. O processamento é feito no seu navegador.

Ferramentas relacionadas

Continue com estas ferramentas

Ferramentas semelhantes ou complementares a esta.

Ferramentas semelhantes

Validador de URL

Valide, normalize e inspecione endereços Web localmente.

Web e SEOUtilizar esta ferramenta

Gerador de slug

Transforme um título ou uma frase num slug limpo e pronto para usar numa URL.

Web e SEOUtilizar esta ferramenta

Leia também

GuiaBoas práticasIniciante

Criar URLs limpas: slugs, parâmetros e normalização

Aprenda a conceber URLs estáveis e legíveis, gerar slugs coerentes, gerir parâmetros de query e evitar variantes desnecessárias que complicam o SEO técnico.

29 de agosto de 20263 min
TutorialBoas práticasIniciante

Otimizar imagens para a Web sem perder qualidade

Redimensionamento, compressão, WebP, AVIF e boas práticas: um método completo para tornar as imagens de um site mais leves sem degradar desnecessariamente o resultado.

30 de agosto de 20264 min