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= のように空の値になります。