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=.