Construtor de URL Query

Como usar

1. Digite a base URL. Se já tiver `?`, o builder anexa o resto com `&`.
2. Adicione linhas key-value. Alterne a checkbox pra incluir / excluir uma linha sem deletar.
3. Escolha `%20` ou `+` pra espaços conforme o servidor espera URI encoding padrão ou form-encoded.

Perguntas frequentes

Quando uso `+` pra espaços?

Quando o servidor trata a query string como `application/x-www-form-urlencoded` — maioria dos form handlers antigos e scripts CGI fazem isso. APIs REST modernas geralmente aceitam ambos, mas o default seguro pra POST `application/json` é `%20`.

Chaves duplicadas são permitidas?

Sim — maioria dos servidores trata chaves repetidas como array. Alguns só mantêm a última; verifique a doc da API se não estiver certo.

Quais caracteres precisam ser codificados dentro de um valor?

Tudo o que de outro modo seria lido como estrutura: o e comercial, o sinal de igual, o espaço e, acima de tudo, a cerquilha. O que vem depois de uma cerquilha é o fragmento e nunca é enviado ao servidor, então uma única cerquilha sem codificar corta em silêncio o resto do valor. Barras e dois-pontos são válidos dentro da query string e podem ficar como estão, embora codificá-los não faça mal.

A ordem dos parâmetros importa?

Para o servidor, não: ele pode lê-los em qualquer ordem. Para todo o resto, sim. Caches e CDNs usam o texto exato da URL como chave, então os mesmos parâmetros em outra ordem viram outra entrada de cache, e tudo que assina ou compara URLs — analytics, links assinados, deduplicação — enxerga duas strings diferentes. Mantenha a ordem estável mesmo sem obrigação.

Ferramentas relacionadas