コンテンツへスキップ

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

OneClick Proについて

OneClick Proは、日々の作業に役立つ150以上のウェブツールを集めた無料コレクションです。画像や単位の変換、コードの整形と検証、ドメインやSEOの確認、テキスト、日付、数値の処理などに利用できます。すべてのツールは登録やサブスクリプションなしで使えます。入力した内容は結果の計算にのみ使用され、保存されることはありません。単発の作業に使える便利なツールボックスとして、または毎日使うツールをブックマークしてご活用ください。