Ajuda

URL Builder para parâmetros de consulta

Digite um endereço e alguns pares de chave e valor, e este URL Builder monta a query string: ele coloca o ? e o &, codifica espaços e caracteres especiais e atualiza o link a cada tecla. Funciona com uma URL completa e com um caminho como /api/search, e você escolhe se o espaço vira %20 ou +. Tudo acontece no seu navegador: nada é enviado e você não precisa de conta.


Como colocar parâmetros em uma URL, passo a passo

  1. Digite o endereço em URL base. Uma URL completa, um caminho ou qualquer outro texto é aceito e nunca é recusado.
  2. Em Parâmetros, digite uma chave e um valor na primeira linha, por exemplo utm_source e newsletter. Pressione Adicionar parâmetro para cada par a mais. O botão de remover no fim da linha apaga aquela linha.
  3. Leia o link em URL gerada. Ele muda enquanto você digita, e as linhas aparecem na URL na mesma ordem da lista.
  4. Deixe Modo de codificação no padrão ou troque, e depois pressione Copiar URL. O botão mostra "Copiado" por um instante.

Um exemplo: a URL base https://example.com/search#results com q = red shoes & socks, utm_source = newsletter e lang = café resulta, no modo padrão, em https://example.com/search?q=red%20shoes%20%26%20socks&utm_source=newsletter&lang=caf%C3%A9#results. O fragmento #results fica no final, não importa quantas linhas você acrescente.

Alterar uma URL que já tem parâmetros

Cole um link como https://example.com/shop?color=dark+blue&size=M#reviews em URL base. A base passa a ser https://example.com/shop#reviews e duas linhas aparecem em Parâmetros: color = dark blue e size = M. Mude um valor, apague uma linha ou crie outra, e o link é refeito. Se você digitar a base à mão, a consulta passa para as linhas quando você sai do campo ou pressiona Enter, então um ?ke pela metade não é cortado sob o cursor.

Os %20 e + que já existiam são decodificados nas caixas e codificados de novo na saída. Um + em uma consulta colada é lido como espaço, porque é isso que ele significa em uma query string. Um sinal de mais de verdade é escrito %2B.

Espaço como %20 ou +: qual modo de codificação?

Os dois modos codificam com porcentagem tudo o que não é seguro. Eles diferem na forma de escrever o espaço e em dois caracteres pouco usados.

O URI padrão segue a RFC 3986: só letras, dígitos e - . _ ~ ficam como estão, e ! * ' ( ) / & = # % são codificados. É o certo para quase qualquer link, inclusive em e-mails e posts sociais. A codificação de formulário é o formato application/x-www-form-urlencoded que um formulário HTML envia. Escolha-a só para um endpoint que espera + no lugar de espaços, como um formulário de busca antigo ou uma API escrita para envios de formulário.

Chaves, valores e linhas vazias

Gerador de UTM: criar link UTM

Para criar link UTM, digite o endereço da sua página em URL base e coloque uma linha por tag: utm_source com newsletter, utm_medium com email, utm_campaign com spring_sale. É assim também que você faz para gerar link com UTM.

Não é um gerador de UTM com campos fixos. Não há predefinições, listas suspensas nem campos de campanha: utm_source, utm_medium e utm_campaign são chaves comuns que você mesmo digita. Por isso serve qualquer esquema de rastreamento, parâmetro de API ou nome de filtro, mas a ferramenta não confere como você nomeia as coisas.

O que a ferramenta não faz e o que vem depois

É um construtor simples de chaves e valores, uma espécie de construtor de URL sem recursos extras. Ele não encurta links, não verifica se um endereço abre e coloca parâmetros em uma única URL por vez. Uma URL base sem https:// na frente, como example.com, é tratada como o texto que você digitou, sem esquema acrescentado.

Para levar o link a um cartaz ou panfleto, transforme-o em código com o Gerador de QR Code Estático. Para tirar antes os links de um texto ou de HTML, use o Extrator de URLs, e para comparar um endereço com um padrão, o Testador de Regex.


Perguntas frequentes

Como colocar parâmetros de consulta em uma URL?

Digite ou cole o endereço em "URL base" e preencha uma chave e um valor na lista "Parâmetros". A caixa "URL gerada" mostra o link com o ? ou o & já colocado e os caracteres especiais codificados. Pressione "Copiar URL" para levá-lo.

Como colocar vários parâmetros em uma URL?

Pressione "Adicionar parâmetro" para cada par extra. As linhas são unidas com & na ordem da lista, então a primeira linha vem primeiro na URL. Use o botão de remover no fim da linha para tirar um par.

O espaço em uma URL deve ser %20 ou +?

%20 é seguro quase em qualquer lugar, por isso "URI padrão (espaço como %20)" é a opção padrão. Um + só significa espaço dentro de uma query string, e só para servidores que a leem como dados de formulário. Escolha "Codificação de formulário (espaço como +)" quando um endpoint ou um formulário HTML esperar isso.

Como criar um link UTM?

Digite o endereço da sua página em "URL base" e coloque uma linha por tag: utm_source com newsletter, utm_medium com email, utm_campaign com spring_sale. A ferramenta as trata como qualquer outra chave, então não há campos predefinidos nem listas para campanhas, e a nomenclatura não é conferida.

Como é a query string de uma URL?

É a parte depois do ?, formada por pares chave=valor unidos por &, por exemplo https://example.com/shop?color=blue&size=M. Tudo depois de um # é o fragmento e não faz parte da query string.

Posso alterar uma URL que já tem parâmetros?

Sim. Cole o link completo em "URL base". Os parâmetros vão para a lista "Parâmetros", decodificados para você ler e mudar, e a base mantém o caminho e o #fragmento, se houver. O texto que você digita é dividido quando você sai do campo ou pressiona Enter.

O que acontece com o #fragmento, as linhas vazias e as chaves repetidas?

O #fragmento fica sempre por último. Uma chave sem valor resulta em chave=, uma linha vazia é ignorada, e um valor sem chave fica fora da URL com um aviso até você colocar a chave. Chaves repetidas mantêm a ordem: page=2 e depois page=3 resulta em ?page=2&page=3.

A ferramenta encurta o link ou verifica se ele funciona?

Não. Ela só monta o texto da URL. Não encurta links, não testa se o endereço abre e não coloca parâmetros em várias URLs de uma vez.

Minha URL é enviada para algum lugar?

Não. O link é montado no seu navegador e nada é enviado nem salvo, então uma URL com um token ou com o nome de um host interno continua no seu dispositivo.