JSON vers Query String
Créez une chaîne de requête URL à partir d'un objet JSON. Chaque valeur est encodée selon le codage en pourcentage, les objets imbriqués utilisent la notation entre crochets, telle que filter[status]=open, et les tableaux sont écrits avec des clés répétées, des crochets, des index ou des listes séparées par des virgules. Choisissez %20 ou + pour les espaces, selon le serveur qui lit l'URL.
Foire aux questions
Quels formats de tableau sont disponibles ?
Repeat écrit ids=1&ids=2, brackets écrit ids[]=1&ids[]=2, indices écrit ids[0]=1&ids[1]=2 et comma écrit ids=1,2. Repeat est le format envoyé par URLSearchParams et la plupart des clients HTTP ; PHP et Rails attendent des crochets ou des index.
Comment les objets imbriqués sont-ils écrits ?
Avec la notation entre crochets : {"filter": {"status": "open"}} devient filter[status]=open. Les objets plus profonds ajoutent des crochets, par exemple a[b][c]=1.
Faut-il utiliser %20 ou + pour les espaces ?
Les deux représentent un espace dans une chaîne de requête. %20 convient à n’importe quelle partie d’une URL, tandis que + est utilisé par les formulaires HTML. La plupart des serveurs acceptent les deux ; choisissez donc celui utilisé par votre serveur ou sa documentation API.
Pourquoi les crochets sont-ils encodés en %5B et %5D ?
Les crochets sont des caractères réservés dans les URL, ils sont donc encodés en pourcentage par défaut, comme le font http_build_query de PHP et la bibliothèque qs. Activez les crochets lisibles pour les conserver sous la forme [ et ], que la plupart des serveurs acceptent également.
Quels caractères ne sont pas encodés ?
Les lettres, les chiffres et les caractères - _ . ! ~ * ' ( ) sont conservés tels quels. Tout le reste, notamment &, =, # et les lettres non ASCII, est encodé en pourcentage en UTF-8.
Comment sont écrits null et les booléens ?
true, false et les nombres sont écrits sous forme de texte, par exemple active=true. null devient une valeur vide, comme dans note=.