# JSON para Query String

Crie uma query string URL a partir de um objeto JSON. Cada valor é codificado com percent-encoding; objetos aninhados usam notação com colchetes, como filter[status]=open, e matrizes são escritas como chaves repetidas, com colchetes, com índices ou como listas separadas por vírgulas. Escolha %20 ou + para espaços, de acordo com o servidor que lê a URL.

## Perguntas frequentes

### Quais formatos de matriz estão disponíveis?

O formato Repeat grava ids=1&ids=2, Brackets grava ids[]=1&ids[]=2, Indices grava ids[0]=1&ids[1]=2 e Comma grava ids=1,2. Repeat é o formato enviado por URLSearchParams e pela maioria dos clientes HTTP; PHP e Rails esperam colchetes ou índices.

### Como objetos aninhados são escritos?

Com a notação de colchetes: {"filter": {"status": "open"}} se torna filter[status]=open. Objetos mais profundos adicionam mais colchetes, como a[b][c]=1.

### Espaços devem ser %20 ou +?

Ambos representam um espaço em uma query string. %20 é correto em qualquer parte de uma URL, enquanto + é o que os formulários HTML enviam. A maioria dos servidores aceita ambos, então escolha o formato usado pelo seu servidor ou pela documentação de API.

### Por que os colchetes são codificados como %5B e %5D?

Colchetes são caracteres reservados em URLs, por isso são codificados como porcentagem por padrão, como fazem o http_build_query de PHP e a biblioteca qs. Ative os colchetes legíveis para mantê-los como [ e ], que a maioria dos servidores também aceita.

### Quais caracteres não são codificados?

Letras, dígitos e os caracteres - _ . ! ~ * ' ( ) são mantidos como estão. Todo o restante, incluindo &, =, # e letras não ASCII, é codificado como porcentagem em UTF-8.

### Como null e valores booleanos são escritos?

true, false e números são escritos como texto, por exemplo, active=true. null se torna um valor vazio, como note=.

Seu anúncio aqui?

[Envie-nos um e-mail](mailto:hi@dennn.is?subject=Publicidade%20em%20OneClick%20Pro)

[Anúncio 433 ferramentas para seus agentes de IA por meio de um único servidor MCP.](https://multitaskai.com/pt/?ref=oneclickpro)
