# JSONからクエリ文字列へ

JSONオブジェクトからURLクエリ文字列を作成します。すべての値はパーセントエンコードされます。ネストされたオブジェクトにはfilter[status]=openのようなブラケット記法が使われます。配列は、キーの繰り返し、ブラケット、インデックス、またはカンマ区切りのリストで書き込めます。URLを読み込むサーバーに合わせて、スペースには%20または+を選択できます。

## よくある質問

### 利用できる配列形式は何ですか？

Repeat形式ではids=1&ids=2、brackets形式ではids[]=1&ids[]=2、indices形式ではids[0]=1&ids[1]=2、comma形式ではids=1,2になります。Repeat形式はURLSearchParamsやほとんどのHTTPクライアントが送信する形式です。PHPとRailsでは、brackets形式またはindices形式が使われます。

### ネストされたオブジェクトはどのように書き込まれますか？

ブラケット記法では、{"filter": {"status": "open"}} は filter[status]=open になります。さらに深いオブジェクトでは、a[b][c]=1 のようにブラケットが増えます。

### スペースは %20 と + のどちらで表しますか？

クエリ文字列ではどちらもスペースを表します。%20 は URL のどの部分でも正しく使えますが、+ は HTML フォームで使われます。ほとんどのサーバーは両方に対応しているため、サーバーまたは API のドキュメントで使われている方を選んでください。

### ブラケットが %5B と %5D にエンコードされるのはなぜですか？

角括弧は URL で予約されている文字のため、PHP の http_build_query や qs ライブラリのように、デフォルトではパーセントエンコードされます。読みやすいブラケットを有効にすると、ほとんどのサーバーが受け付ける [ と ] のままにできます。

### エンコードされずに残る文字はどれですか？

英字、数字、および - _ . ! ~ * ' ( ) はそのまま残ります。&, =, #、ASCII 以外の文字など、それ以外の文字はすべて UTF-8 としてパーセントエンコードされます。

### null とブール値はどのように記述されますか？

true、false、数値はテキストとして記述されます。たとえば active=true です。null は note= のように空の値になります。

ここに広告を掲載しませんか？

[メールでお問い合わせ](mailto:hi@dennn.is?subject=OneClick%20Pro%E3%81%A7%E3%81%AE%E5%BA%83%E5%91%8A%E6%8E%B2%E8%BC%89)

[広告 433 個のツールを1つのMCPサーバーでAIエージェントに提供します。](https://multitaskai.com/ja/?ref=oneclickpro)
