JSONとGETパラメータのオンライン相互変換、無料双方向変換

JSONの階層をURLクエリ文字列に展開

JSONはオブジェクトや配列を含む構造化データを記述し、URLのクエリ文字列は一般に名前=値の組を&で連結したテキストです。この変換ツールでは、JSONをクエリ文字列へ変換する方向と、クエリ文字列を整形されたJSONへ戻す方向を切り替えられます。ここでいうクエリ文字列は、URLの?以降に付くパラメータ部分です。IETF RFC 8259はJSONが文字列・数値・真偽値・null・オブジェクト・配列を表す形式であることを定義し、WHATWG URL StandardはURLとそのクエリの構文を定めています。JSONの階層をクエリへ写す方法は単一の形に決まっているわけではないため、出力形式を接続先の仕様に合わせる必要があります。

入れ子のキーと配列の書き方

オブジェクトの階層は、たとえば{"filter":{"status":"open"}}からfilter[status]=openのように、キー名を角括弧でつないで展開できます。配列については、角括弧を付けるtag[]=a&tag[]=b、添字を付けるtag[0]=a&tag[1]=b、同じキーを繰り返すtag=a&tag=bの3形式を選べます。空白や日本語などを含む値はURLエンコードを有効にするとパーセント表記になり、URLに付けるための先頭の?も必要に応じて追加できます。

クエリからJSONに戻すときに残る情報

逆変換では、角括弧のキーをネストしたオブジェクトや配列に組み立て、同じキーが繰り返される場合は値を配列にまとめます。出力例はpage=2&tag[]=web&tag[]=apiから{"page":"2","tag":["web","api"]}です。クエリ値はテキストなので、2は数値の2ではなく文字列"2"になり、trueも真偽値には自動変換されません。

変換方向と出力形式を選ぶ

1. 目的の方向を指定

   JSONからパラメータを作る場合は「JSON → GET」、既存のパラメータを読みやすくする場合は「GET → JSON」を選びます。入力例を表示して形を確認することもできます。

2. 入力を貼り付ける

   JSON側には妥当なJSONテキストを、逆変換側にはpage=2&filters[status]=openのようなクエリ部分を入力します。クエリ文字列に含まれる&や=も含めて貼り付けてください。

3. 配列とエンコードを合わせる

   JSONからの変換では、接続先が受け取る配列表現を選びます。URLエンコードを有効にすると値の記号や日本語がパーセント表記になり、クエリ先頭に?を付ける設定も使えます。逆変換では同じ設定がデコードの切り替えになります。

4. 結果を確認してコピー

   表示された結果を読み、キー名、配列の形、文字コードが接続先の要件に合っているか確認します。問題なければ結果欄のコピー操作で持ち出せます。たとえば{"page":2,"tags":["json","api"]}を角括弧配列で出力すると、page=2&tags[]=json&tags[]=apiになります。

変換時によく確認される点

送信前に接続先の規約と値を確認

この変換はテキスト表現の整理であり、接続先のAPIがキーや配列形式を受理するかは判定しません。角括弧・添字・重複キーの扱いはサーバーやAPIごとに異なります。必ず対象サービスの仕様と照合してください。

逆変換ではパラメータ値を文字列として出力するため、数値・真偽値・nullなどのJSON型情報は保持されません。また、空のオブジェクトや配列などをクエリ文字列に展開すると、元の構造を完全に復元できない場合があります。エンコード設定、重複キー、キー名を確認し、署名付きURLや認証情報を含む値は共有先にも注意して扱ってください。