Conversor de query string para JSON

Este conversor de query string para JSON transforma esse formato compacto de transporte em um objeto estruturado que você pode ler, copiar, comparar ou integrar a um fluxo de depuração. Ele decodifica escapes percentuais como UTF-8, interpreta sinais de mais como espaços, mantém valores vazios visíveis e representa nomes de parâmetros repetidos como listas na ordem original. A transformação é determinística e adequada para analisar requisições, montar dados de teste, revisar logs e desenvolver ferramentas internas.

Transforme parâmetros compactos em um objeto fácil de inspecionar

Query strings foram criadas para transportar dados, não para oferecer uma leitura confortável. Um navegador ou cliente pode enviar em uma única linha compacta um termo de busca, várias etiquetas selecionadas, um campo opcional vazio e uma localização com caracteres internacionais. Cole no conversor a parte que vem depois do caminho da URL, com ou sem o ponto de interrogação inicial, e o resultado separará cada parâmetro em uma propriedade JSON. Um parâmetro escrito sem sinal de igual é mantido com uma string vazia, assim como um parâmetro seguido explicitamente por um sinal de igual sem conteúdo. Segmentos vazios entre os sinais de e comercial são ignorados, pois não contêm parâmetros. Isso permite comparar a saída com o estado da aplicação: os valores ficam visíveis, os vazios não somem e os contadores mostram tanto as chaves distintas quanto o total de pares processados. O analisador não acessa o servidor de destino nem deduz tipos de negócio; valores como true, 42 e null continuam sendo strings. Esse comportamento previsível torna o JSON uma representação fiel do que a consulta realmente transportou.

Entenda a decodificação e o tratamento de chaves repetidas

Cada chave e cada valor são decodificados separadamente segundo as regras convencionais de formulários web. Um sinal de mais vira espaço, enquanto escapes percentuais como %20 e sequências UTF-8 com vários bytes tornam-se os caracteres pretendidos. O sinal de igual é especial somente em sua primeira ocorrência dentro de cada par; por isso, um valor pode conter outros sinais de igual sem ser dividido novamente. Chaves repetidas são preservadas em vez de sobrescritas: a primeira ocorrência começa como string, a segunda transforma a propriedade em uma lista e as próximas são acrescentadas na ordem recebida. Por exemplo, tag=sale&tag=new produz uma lista tag com sale antes de new. Isso ajuda a analisar filtros, grupos de caixas de seleção e frameworks que serializam múltiplas escolhas sob um único nome. Escapes percentuais inválidos geram um erro de entrada em vez de uma decodificação parcial, e bytes codificados que não formam UTF-8 válido também são recusados. Essa falha estrita evita que um resultado aparentemente plausível esconda uma requisição malformada. pair_count inclui repetições, enquanto key_count informa quantos nomes decodificados são distintos.

Use o resultado em testes, logs e diagnóstico de requisições

O objeto convertido funciona bem sempre que você precisa compreender uma consulta antes que o código aja sobre ela. Durante o desenvolvimento de uma API, cole a query string de uma requisição com falha e compare o JSON decodificado aos parâmetros esperados pela rota. Em testes automatizados, converta strings representativas em dados estáveis e confirme que filtros repetidos, texto internacional, sinais de mais e campos vazios chegam no formato previsto. Ao revisar logs, a estrutura é mais fácil de ler e comparar do que uma linha longa codificada, especialmente quando a mesma chave aparece várias vezes. O conversor evita deliberadamente coerção de esquema: se a sua aplicação espera número, booleano, data ou uma convenção aninhada com colchetes, aplique depois a validação específica dela. Esse limite impede que uma ferramenta genérica invente significados que o remetente não declarou. Os nomes de propriedades são tratados com segurança como dados, inclusive quando lembram elementos internos do JavaScript. Use a versão no navegador para verificações rápidas ou chame a API por US$ 0,002 quando um pipeline, executor de testes ou fluxo de observabilidade precisar repetir a mesma conversão determinística.