Pular para o conteúdo
Aback Tools Logo

Gerador de string de consulta

Crie, codifique e decodifique strings de consulta de URL com o nosso Gerador de string de consulta gratuito. Adicione pares chave-valor numa interface de tabela limpa — os valores são codificados em URL automaticamente. Escolha entre os modos de codificação Padrão, Formulário codificado para URL ou Mínimo conforme o seu caso de uso. Carregue predefinições para consultas de pesquisa, campanhas UTM, paginação de API e fluxos de autenticação OAuth, ou importe uma string de consulta existente para editá-la. Copie com ou sem o símbolo ? inicial — sem cadastro.

Query String Builder

Build a query string from key-value pairs. Add, remove, and reorder parameters. Values are automatically URL-encoded. Copy the resulting query string or full URL with one click - no signup required.

1

Porquê usar o nosso Gerador de string de consulta?

  • Crie strings de consulta visualmente: Adicione, remova e edite pares chave-valor numa interface de tabela limpa. Não precisa de escrever manualmente os separadores & e =. Cada linha de parâmetro tem campos dedicados para a chave e o valor, com validação em tempo real e codificação de URL automática, o que facilita a criação de strings de consulta complexas sem erros de sintaxe.
  • Cópia e exportação instantâneas: Copie a string de consulta com ou sem o símbolo ? inicial com um clique. A ferramenta também mostra uma pré-visualização do URL completo para ver exatamente como a string de consulta ficará no seu contexto. Perfeito para gerar rapidamente links de rastreamento, chamadas de API e URL de redirecionamento.
  • Predefinições e importação de string: Carregue predefinições prontas para cenários comuns como consultas de pesquisa, parâmetros de campanha UTM, paginação de API e fluxos de autenticação OAuth2. Também pode colar uma string de consulta existente para importar e editar os seus parâmetros, o que facilita o trabalho com URL já existentes.
  • Vários modos de codificação: Escolha entre os modos Padrão (encodeURIComponent), Formulário codificado para URL (+ para espaços) e Mínimo. Cada modo é adequado a contextos diferentes — chamadas de API, submissões de formulários ou URL de navegador. Veja as vistas codificada e descodificada lado a lado.

Casos de uso comuns do Gerador de string de consulta

  • Construção de URL de API: Crie URL de pedido de API REST com parâmetros de consulta para filtrar, ordenar, paginar e selecionar campos. Gere rapidamente endpoints de API para testar em ferramentas como o Postman, o cURL ou diretamente no navegador, garantindo a codificação de URL correta dos caracteres especiais.
  • Geração de links de campanha UTM: Crie URL de rastreamento para campanhas de marketing com os parâmetros UTM adequados (utm_source, utm_medium, utm_campaign, utm_content, utm_term). Use a predefinição Campanha UTM para garantir um rastreamento consistente em todos os seus canais de marketing.
  • URL de autorização OAuth2: Crie URL de pedido de autorização OAuth2 com os parâmetros response_type, client_id, redirect_uri, scope e state. A predefinição Fluxo de autenticação fornece um ponto de partida, e a ferramenta garante que todos os parâmetros estão corretamente codificados em URL para fluxos OAuth seguros.
  • Criação de consultas de pesquisa e filtragem: Construa consultas de pesquisa e filtragem para sites de comércio eletrónico, diretórios ou painéis de dados. Combine categoria, intervalo de preços, avaliações, ordem de ordenação e paginação num URL limpo e funcional para testar ou partilhar.
  • Desenvolvimento e depuração web: Crie e depure strings de consulta durante o desenvolvimento. Teste como a sua aplicação lida com diferentes combinações de parâmetros, chaves duplicadas, valores vazios e caracteres especiais. Importe uma string de consulta existente para a inspecionar e modificar.
  • SEO e otimização de URL: Analise e otimize os parâmetros de consulta de URL para SEO. Garanta que os parâmetros estão limpos, evite chaves duplicadas que podem confundir os rastreadores e gere estruturas de URL consistentes para sistemas de gestão de conteúdos e plataformas de comércio eletrónico.

O que é uma string de consulta?

Uma string de consulta é a parte de um URL que aparece depois do caractere ?. Contém pares chave-valor separados por &, usados para transmitir dados a servidores web, APIs e aplicações. Por exemplo, em https://example.com/search?q=hello&page=1, a string de consulta é ?q=hello&page=1, onde q é o termo de pesquisa e page controla a paginação. As strings de consulta estão definidas na especificação de URL (RFC 3986) e são uma parte fundamental da forma como a web transmite parâmetros entre clientes e servidores.

Como funciona o nosso Gerador de string de consulta

  1. Adicione parâmetros: Comece por adicionar pares chave-valor à tabela. Cada linha tem um campo para a chave e um campo para o valor. Adicione quantos parâmetros precisar com o botão «Adicionar parâmetro». Remova os que não quer com o botão de eliminar.
  2. Escolha a codificação: Selecione o modo de codificação que corresponde ao seu caso de uso. O modo Padrão usa encodeURIComponent() para uma conformidade rigorosa com a RFC 3986. O modo Formulário codificado para URL usa + para os espaços (para application/x-www-form-urlencoded). O modo Mínimo só codifica os caracteres não seguros para melhorar a legibilidade.
  3. Obtenha o resultado: A string de consulta é criada automaticamente à medida que escreve. Copie-a com ou sem o ? inicial, veja a pré-visualização do URL completo, ou use a funcionalidade «Importar de string» para carregar uma string de consulta existente e editá-la.

A codificação de strings de consulta explicada

A codificação de URL (também conhecida como codificação percentual) substitui os caracteres não permitidos em URL por um % seguido de dois dígitos hexadecimais. Os três modos de codificação da nossa ferramenta tratam isto de forma diferente:

  • Padrão (encodeURIComponent) — Codifica todos os caracteres exceto os não reservados (A-Z, a-z, 0-9, -, _, ., ~). Os espaços tornam-se %20. É a opção mais segura para chamadas de API e para a maioria das aplicações web.
  • Formulário codificado para URL — Igual ao padrão, mas codifica os espaços como + (seguindo a especificação application/x-www-form-urlencoded). É necessário quando se imitam submissões de formulários HTML.
  • Mínimo — Só codifica os caracteres que não são definitivamente permitidos nas strings de consulta (#, &, ?, =, %, espaços em branco). Produz URL mais legíveis, mas pode não ser compatível com todos os servidores.

Privacidade, segurança e disponibilidade

O nosso Gerador de string de consulta processa tudo inteiramente no seu navegador. Nenhum dado é enviado para qualquer servidor — toda a codificação de URL, a análise e o processamento acontecem no lado do cliente com as funções integradas encodeURIComponent() e decodeURIComponent() do JavaScript. A ferramenta é 100% gratuita, sem cadastro, sem conta e sem limites de utilização. Sem cookies, sem rastreamento e sem recolha de dados. Basta carregar a página e começar imediatamente a criar strings de consulta.

Perguntas frequentes

Uma string de consulta é a parte de um URL que vem depois do caractere ?, contendo pares chave-valor separados por &. É utilizada para transmitir dados a servidores web, APIs e aplicações. Os usos comuns incluem consultas de pesquisa, parâmetros de rastreamento, filtros de API e parâmetros de autenticação. As strings de consulta estão definidas na RFC 3986 e são suportadas por todos os servidores web e navegadores.

A codificação de URL (codificação percentual) converte os caracteres não permitidos em URL num formato seguro. Caracteres como o espaço, &, #, ? e = têm de ser codificados porque têm um significado especial nos URL. Por exemplo, um espaço torna-se %20 (ou + na codificação de formulários) e um & torna-se %26. Sem uma codificação de URL adequada, as strings de consulta podem quebrar os URL, causar erros de análise ou introduzir vulnerabilidades de segurança como a injeção de parâmetros.

O modo Padrão usa encodeURIComponent(), que codifica todos os caracteres especiais e usa %20 para os espaços. O modo Formulário codificado para URL usa + para os espaços, seguindo a especificação application/x-www-form-urlencoded usada pelos formulários HTML. O modo Mínimo só codifica os caracteres não seguros estritamente necessários (#, &, ?, =, %), produzindo URL mais legíveis, mas pode não ser compatível com todos os servidores.

Sim! Use o modo «Importar de string» para colar uma string de consulta existente (com ou sem o ? inicial). A ferramenta irá analisá-la e preencher a tabela de parâmetros, onde pode adicionar, remover ou modificar parâmetros conforme necessário. Isto é útil para depurar URL existentes, modificar links de rastreamento ou limpar strings de consulta desorganizadas.

A ferramenta permite chaves duplicadas (por exemplo, category=electronics&category=books), o que é válido nas strings de consulta e habitualmente usado pelas APIs. Quando são detetadas duplicações, é apresentado um aviso para que decida se as mantém ou consolida. Alguns servidores tratam as chaves duplicadas como arrays, enquanto outros usam o último valor — a nossa ferramenta suporta ambos os cenários.

Não. O Gerador de string de consulta é executado inteiramente no seu navegador com JavaScript do lado do cliente. Toda a codificação de URL, análise e processamento acontece localmente no seu dispositivo. Nenhum dado é enviado para qualquer servidor, nenhum cookie é definido e nenhuma informação é registada ou armazenada.

Os parâmetros UTM (utm_source, utm_medium, utm_campaign, utm_content, utm_term) são parâmetros de string de consulta usados pelo Google Analytics e outras plataformas para medir o desempenho das campanhas de marketing. Identificam as fontes de tráfego, os canais e as campanhas específicas. Use a predefinição Campanha UTM da nossa ferramenta para começar rapidamente.

Sim! 100% gratuito, sem cadastro, sem conta e sem limites de utilização. Crie tantas strings de consulta quantas precisar — para APIs, campanhas de marketing, desenvolvimento, testes ou qualquer outro fim — totalmente grátis, para sempre.