Construtor de String de Consulta
Monte uma string de consulta corretamente codificada a partir de uma lista de pares chave-valor. O construtor lida com caracteres reservados, espaços e entradas não ASCII da maneira que o RFC 3986 espera, para que você possa inserir o resultado diretamente em uma URL sem quebrar em e comercial ou sinais de igual.
Como construir uma string de consulta
-
1
Adicione seus pares
Digite cada nome e valor de parâmetro. Adicione mais linhas para chaves extras.
-
2
Deixe a codificação acontecer
Espaços viram %20, textos não ASCII recebem codificação percentual UTF-8 e caracteres reservados como & = # ? são protegidos.
-
3
Copie a saída
Prependa-a à sua URL com ? ou cole-a no Postman, curl ou em uma chamada fetch().
O que é codificado
De acordo com o RFC 3986, qualquer coisa fora do conjunto não reservado (A-Z a-z 0-9 - _ . ~) deve ser codificada em percentagem dentro de um componente de consulta. Na prática, isso significa:
| Caractere | Codificado como | Por quê |
|---|---|---|
| espaço | %20 ou + |
Ambíguo entre contextos |
& |
%26 |
Separa pares, quebraria a string |
= |
%3D |
Separa chave de valor |
# |
%23 |
Inicia o fragmento |
? |
%3F |
Inicia a consulta em si |
/ |
%2F |
Seguro em caminhos, arriscado em valores |
Chaves repetidas
Cada linha é codificada separadamente e mantém a ordem original. Duas linhas com tag geram tag=a&tag=b. Se o servidor exigir colchetes, digite tag[] como chave. A ferramenta não tenta adivinhar a convenção do framework.
Dicas
- Sempre codifique valores fornecidos pelo usuário; nunca os concatene brutos na URL.
- Se um valor parecer binário, codifique-o em base64url antes de inseri-lo.
Perguntas frequentes
O construtor sempre representa espaços como %20 segundo a RFC 3986. O analisador também aceita + e o converte em espaço nas consultas de formulário.
Repita a chave: tags=php&tags=laravel. Alguns frameworks esperam notação de colchetes como tags[]=php&tags[]=laravel. Combine com o que seu backend analisa.
Isso é codificação de entidade HTML aplicada pelo seu mecanismo de template, não a string de consulta em si. Certifique-se de que você não está escapando a saída duas vezes ao renderizar dentro de um href.
Não existe um único limite prático; navegadores, proxies, CDNs e servidores aplicam limites diferentes. Use o corpo da requisição para cargas grandes.
Ferramentas relacionadas
Referência da Tabela ASCII
Tabela ASCII completa de 0 a 127 com valores decimais, hexadecimais, octais e binários e notação de referência numérica HTML, incluindo NUL, LF e DEL.
Referência de Caracteres HTML
Lista pesquisável de entidades HTML, seus códigos nomeados e numéricos, e uma cópia com um clique para caracteres e símbolos especiais.
Referência de atalhos de teclado
Pesquise atalhos padrão documentados do VS Code, Chrome e Bash com GNU Readline no macOS, Windows e Linux.
Conversor de Tamanho de Arquivo
Converta entre bytes, KB, MB, GB, TB e as unidades binárias IEC (KiB, MiB, GiB, TiB), combinando decimal e binário como preferir.
Gerador de EditorConfig
Monte um .editorconfig com as suas regras de indentação, fim de linha e charset e acrescente a seção correta para cada linguagem do seu repositório: Python, Go, YAML, Makefile e mais.
Validador de Email
Valide um endereço de email: verificação de sintaxe RFC 5322, consulta de registro MX em tempo real, além de detalhes de parte local, domínio e comprimento. Nenhum email é enviado.
Ferramenta disponível em outros idiomas
- Constructor de Cadenas de Consulta [ES]
- Constructeur de chaînes de requête [FR]
- Pembangun String Kueri [ID]
- Frågesträngbyggare [SV]
- クエリ文字列ビルダー [JA]
- 쿼리 문자열 생성기 [KO]
- Query-stringbuilder [NL]
- Bộ tạo chuỗi truy vấn [VI]
- เครื่องมือสร้างสตริงสำหรับคำสั่งค้นหา (Query String Builder) [TH]
- بناء سلسلة الاستعلام (Query String Builder) [AR]
- Query-String-Builder [DE]
- Strument do tworzenia zapytań (Query String Builder) [PL]
- Query String Builder [EN]
- Costruttore di Stringhe di Query [IT]
- Стринг-генератор запросов [RU]
- Sorgu Dizesi Oluşturucu [TR]
- 查询字符串构建器 [ZH]