クエリ文字列パーサー

URLのクエリ文字列やform-urlencoded形式のペイロードをブラウザ上でローカルに解析し、編集可能なキー・バリュー表およびJSONへ変換します。

アップロード不要登録不要リアルタイム変換
キー・値の対話型切替エディター配列・ネスト括弧 → JSONx-www-form-urlencoded (+) と厳密な %20
クエリ文字列を解析
オフラインエンジンの準備完了ブラウザ内100%プライベート空間 • クラウドへのデータ送信ゼロ
100%プライベート • サーバーファイル送信ゼロ

Utiliomeの無料クエリ文字列パーサーを選ぶ理由

厳格なプライバシー保護、即時実行、ストレスフリーを考慮して開発。サブスクリプションや会員登録は不要です。

クエリ文字列とJSONの双方向変換

?key=value 形式の文字列や application/x-www-form-urlencoded ボディを整形されたJSONオブジェクトへと解析し、編集後のJSONを正規化されたクエリパラメータへ即座に再シリアライズします。

重複キー配列とネストされたブラケット構文に対応

重複するキー(?tag=go&tag=rust)、明示的な配列ブラケット(ids[]=1&ids[]=2)、およびネストされたオブジェクト階層(filter[status]=open&page[limit]=50)を正確に解決します。

+ と %20 のスペース出力形式を切り替え可能

入力時は URLSearchParams の仕様に従って + と %20 の両方をスペースとしてデコードし、再構築時には厳格なRFC 3986形式(%20)またはHTMLフォーム形式(+)を選択して出力できます。

サーバー送信なしの対話型パラメータ編集テーブル

APIキー、OAuthのstateトークン、Webhookペイロードを外部サーバーへ一切送信せず、ブラウザメモリ内で安全にパラメータの追加、有効/無効の切り替え、編集、削除を行えます。

Utiliomeと従来のクラウドサービスの比較

ローカルファーストのWebAssemblyエンジンと従来のクラウドツールを比較。

機能 Utiliome (ローカルブラウザ) 従来のクラウドコンバーター
クエリ文字列とJSONの双方向変換 ?key=value 形式の文字列や application/x-www-form-urlencoded ボディを整形されたJSONオブジェクトへと解析し、編集後のJSONを正規化されたクエリパラメータへ即座に再シリアライズします。 基本機能のみで高度なカスタマイズに非対応
重複キー配列とネストされたブラケット構文に対応 重複するキー(?tag=go&tag=rust)、明示的な配列ブラケット(ids[]=1&ids[]=2)、およびネストされたオブジェクト階層(filter[status]=open&page[limit]=50)を正確に解決します。 外部ツールや手作業での変換・調整が必要
データプライバシーと処理方式 100%ブラウザ内ローカル処理(サーバー送信ゼロ) データを外部クラウドサーバーへ送信・保存
利用料金・アカウント登録 完全無料・登録不要・透かしや回数制限なし アカウント登録や有料プランの契約が必要
使い方

クエリ文字列パーサーの使い方(簡単3ステップ)

ソフトウェアのインストールは不要です。すべてお使いのWebブラウザ内で直接動作します。

1

クエリ文字列、完全なURL、またはJSONを貼り付け

生の ?a=1&b=2 クエリ文字列、完全なURL(検索コンポーネントを自動抽出します)、application/x-www-form-urlencoded ボディ、または有効なJSONを入力します。

2

キー、配列、エンコードオプションを編集

対話型のキー・バリュー表またはJSONエディターでデコードされた名前と値を変更し、行ごとの有効/無効を切り替え、配列記法とスペースのエンコードモードを選択します。

3

再構築されたクエリ文字列またはJSONをコピー

cURLコマンドやAPIクライアント向けに適切にエスケープされたクエリ文字列をコピーするか、構造化されたJSONドキュメントをテストスイートやリクエストフィクスチャへ直接エクスポートします。

複雑なクエリ文字列やフォームペイロードからJSONへの変換

クイック回答: クエリ文字列パーサーは、デコード処理の前にまず入力バイト列を & デリミタで分割し、各トークンを最初の = で切り離した上で、+ および %XX のUTF-8シーケンスをデコードし、重複キーやブラケット記法のキー(tag=a&tag=b、filter[status]=open)をJSONの配列やネストされたオブジェクトへと集約します。

現代のREST API、GETリクエストによるGraphQL、およびWebhookエンドポイントでは、複数値の配列、ネストされたフィルタオブジェクト、Base64カーソル、URLエンコードされた検索フレーズを単一のクエリ文字列や application/x-www-form-urlencoded リクエストボディに詰め込むことが一般的です。これらのペイロードをフラットな生の文字列のまま確認・編集しようとすると、%26 エスケープの破損やブラケットの不一致を招きやすくなります。

例えば、+ でエンコードされた空白、重複キー、ネストされたブラケットフィルタ、パーセントエンコードされた = パディングを含むBase64ページネーションカーソル、および値なしのフラグパラメータを組み合わせたAPI検索クエリを考えてみましょう。

?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run

この文字列をパースすると、可読性が高く厳密に構造化されたJSON表現が即座に得られます。

{
  "q": "distributed tracing",
  "tag": [
    "otel",
    "grpc"
  ],
  "filter": {
    "status": "open",
    "priority": "high"
  },
  "cursor": "eyJpZCI6NDIwfQ==",
  "dry_run": ""
}

パーセントデコードよりもデリミタ分割を先に行うべき理由

cursor=eyJpZCI6NDIwfQ%3D%3D が "eyJpZCI6NDIwfQ==" へと綺麗にデコードされている点に注目してください。パーサーはまず生の文字列を & で分割し、各ペアを最初のリテラル = で分割し、その後で初めて + と %XX シーケンスをデコードします。もし単純なスクリプトで & や = で分割する前にクエリ文字列全体に対して decodeURIComponent() を実行してしまうと、エスケープされたアンパサンドを含むパラメータ値(R%26D -> R&D)が2つの不正なパラメータに分裂してしまいます。

JSONビューとキー・バリュー表は双方向にリアルタイム同期されるため、アプリケーションコードからJSONフィルタオブジェクトを貼り付けて、HTTPリクエストにそのまま使える適切にエスケープされたクエリ文字列を即座に生成することも可能です。

WHATWG URLSearchParamsとRFC 3986の違いおよびバックエンドの配列記法

クイック回答: RFC 3986はクエリコンポーネントを非構造化文字列として扱い、スペースを %20 にエンコードして + をそのままリテラルとして保持します。一方、WHATWGの application/x-www-form-urlencoded 標準(URLSearchParams)はスペースを + としてエンコードし、配列やネストされたオブジェクトの構文は各フレームワークの慣習に委ねています。

Web上のクエリ文字列には2つの異なる仕様が存在し、両者の不一致はHTTP連携における署名検証エラーやパラメータバグの最も一般的な原因の一つとなっています。

`application/x-www-form-urlencoded` アルゴリズムとRFC 3986の比較

HTMLフォームおよびJavaScriptの URLSearchParams APIは、WHATWGの application/x-www-form-urlencoded パーサーを実装しています。

  1. location.search から抽出する場合、先頭の ? を除去します。
  2. 入力をバイト 0x26(&)で分割します(&& や先頭の & による空のバイトシーケンスは無視します)。
  3. 各チャンクを最初の 0x3D(=)で分割します。= が存在しない場合、チャンク全体が名前となり、値はデフォルトで "" になります。
  4. 名前と値の両方に含まれるすべての 0x2B(+)バイトを 0x20(ASCIIスペース)に置換します。
  5. %XX の16進数バイトシーケンスをUTF-8としてパーセントデコードし、不正なバイトシーケンスは U+FFFD に置換します。

対照的に、RFC 3986 Section 3.4 は + をスペースとして特別扱いせずにURIクエリコンポーネントを定義しています。厳格な暗号署名プロトコル(特に AWS Signature Version 4 や OAuth 2.0 / RFC 5849 の正規リクエスト)では、スペースを %20 としてエンコードし、+ を %2B としてエンコードすることが求められます。署名付きAPIを対象とする場合は、+ ではなく %20 によるスペースシリアライズを使用してクエリ文字列を再構築してください。

フレームワーク別の配列およびオブジェクトのシリアライズ方式

RFC 3986も URLSearchParams も、ネストされた配列やオブジェクトを標準化していません。バックエンドのエコシステムでは主に以下の4つの慣習が発展しました。

# 1. 重複キー (WHATWG URLSearchParams.getAll, Go net/url, Python parse_qs, Java Servlet)
?tag=otel&tag=grpc

# 2. インデックスなしブラケット (PHP $_GET, Ruby on Rails / Rack, Express qs)
?tag[]=otel&tag[]=grpc

# 3. インデックス付きブラケット (Node.js qs の順序付き配列)
?tag[0]=otel&tag[1]=grpc

# 4. ネストされたオブジェクトキー (Node.js qs, Rails, PHP, Stripe REST API)
?filter[status]=open&filter[created][gte]=1730000000

シリアライズする前に、対象のサーバーが期待する形式を確認してください。例えば、標準のPHPの $_GET['tag'] に対して tag=otel&tag=grpc を送信すると、tag[] ブラケットを使用しない限り最初の値が上書きされてスカラー値 "grpc" が返されます。一方、Goの r.URL.Query()["tag"] はブラケットなしの tag キーを期待します。

セキュリティ特性:HTTPパラメータ汚染とプロトタイプ汚染

  • HTTPパラメータ汚染(HPP: HTTP Parameter Pollution):重複するスカラーキー(?account=user_1&account=user_2)が到着した際、サーバーランタイムによって衝突の解決方法が異なります。Pythonの urllib.parse.parse_qs やGoの Values.Get() は最初の値を読み取り、PHPやRuby Rackは最後の値を読み取り、Node/Expressは配列(["user_1", "user_2"])を生成します。APIゲートウェイが最初の出現値に対して権限チェックを行い、後続のマイクロサービスが最後の出現値を処理する場合、認可チェックがバイパスされる危険性があります。
  • ブラケットパーサーにおけるプロトタイプ汚染(Prototype Pollution):Object.prototype 上で直接 obj[key1][key2] = val を代入する単純なJavaScriptブラケットパーサーは、?__proto__[isAdmin]=true や ?constructor[prototype][isAdmin]=true といったペイロードに対して脆弱です。安全なパーサーは Object.create(null) 辞書をインスタンス化し、予約済みのプロトタイプキーをブロックし、ネストの深さ制限を適用します。

クエリ文字列パーサー、URL構成要素パーサー、URLエンコーダーの使い分け

クイック回答: 対話型のパラメータ編集、配列やブラケット構文の解析、およびJSONとの双方向変換には「クエリ文字列パーサー」を使用してください。スキーム、ホスト、ポート、パスセグメント、ハッシュの分割・編集が必要な場合は「URL構成要素パーサー」を、生の個別文字列のエスケープには「URLエンコーダー&デコーダー」を使用します。

UtiliomeのURL関連ツール群はそれぞれ明確に異なるスコープを扱っており、不要な複雑さを排除した専用コントロールを提供します。

機能 クエリ文字列パーサー(本ツール) URL構成要素パーサー URLエンコーダー&デコーダー パーセントエンコーダー
主な用途 クエリパラメータ、フォームボディ&JSON同期 URI全体の構造解析(RFC 3986 / WHATWG) 生の文字列のエスケープ&アンエスケープ 厳格なRFC 3986 %XX バイトエンコード
JSONとの双方向変換 完全対応(ネストされたオブジェクト&配列) URIフィールドの読み取り専用JSONエクスポート 対象外 対象外
配列&ブラケット構文(a[]=1, f[k]=v) ネイティブ解析&出力形式の切り替え フラットなクエリペア表示 対象外 対象外
+ と %20 のスペース出力切り替え 出力時に設定可能 標準URIコンポーネント正規化 コンポーネント(%20)&フォーム(+)モード 厳格な %20 のみ
スキーム、ホスト、ポート、TLD、パスの編集 クエリ以外のURL部分を自動除去 全コンポーネントの編集&再構築 構造解析なし 構造解析なし

適切なワークフローの選び方

  • スキーム、サブドメイン、TLD、ポート、パスセグメント、またはフラグメントの確認・変更:URL構成要素パーサー に切り替えて、RFC 3986の各境界にわたるURL全体を表示・再構築してください。
  • 予約文字(&、=、+、/)を含む単一の生の値をエスケープする場合:URLエンコーダー&デコーダー を使用して、個別の文字列を確実にエンコードまたはデコードしてください。
  • 厳格なRFC 3986正規エスケープ(!、'、(、)、* -> %XX)を生成する場合:OAuth 1.0aやAWS SigV4の正規クエリ値を構築する際は、パーセントエンコーダー を使用してください。
よくある質問

クエリ文字列パーサーのFAQと技術ガイド

Utiliomeの無料オンラインクエリ文字列 パーサーに関するすべての情報。

URLパラメータ内のリテラルのプラス記号(+)がスペースとしてデコードされるのはなぜですか?

application/x-www-form-urlencoded 標準およびブラウザの URLSearchParams 仕様では、0x2B(+)はエンコードされたスペース(0x20)を表すためです。パラメータ値にISO 8601タイムスタンプのオフセット(2026-11-01T09:30:00+01:00)、Base64トークン、またはE.164電話番号(+14155550100)のようなリテラルのプラス記号が含まれる場合は、%2B として送信する必要があります。事前に URLエンコーダー&デコーダー で個別の文字列をエスケープしておくことができます。

?tag=api&tag=cli のような重複キーはJSONに変換されるとどのように表現されますか?

RFC 8259のJSONオブジェクトでは各階層で一意のキーが求められるため、重複するパラメータ名は出現順にグループ化され、{ "tag": ["api", "cli"] } のようなJSON配列に変換されます。このJSON配列を再びクエリ文字列へ戻す際は、重複キー(tag=api&tag=cli)、空ブラケット(tag[]=api&tag[]=cli)、またはインデックス付きブラケット(tag[0]=api&tag[1]=cli)のいずれかの形式でシリアライズできます。

完全なURLや application/x-www-form-urlencoded のPOSTボディを直接貼り付けることはできますか?

はい、可能です。https://api.example.com/v2/events?limit=25&cursor=abc#section のような完全なURLを貼り付けると、パーサーは ? と # の間にあるクエリ部分文字列(limit=25&cursor=abc)を自動的に抽出します。先頭に ? がない生の application/x-www-form-urlencoded リクエストボディも同様に解析されます。ホスト名、ポート、パスセグメント、またはハッシュも併せて編集したい場合は、URL構成要素パーサー でアドレスを開いてください。

?debug や ?dry_run のようにイコール記号(=)がないフラグパラメータはどう扱われますか?

WHATWGの URLSearchParams 解析アルゴリズムに従い、= を含まないパラメータチャンクはデコード後のパラメータキーがチャンク名("dry_run")に設定され、その値は空文字列("")になります。対話型テーブル上で true などの明示的な値を割り当てることも、パラメータを削除することも、空のまま保持することも可能です。

APIキー、OAuthトークン、Webhookパラメータがバックエンドサーバーに送信されることはありますか?

いいえ、一切ありません。解析、テーブル編集、およびJSONのシリアライズ処理はすべてクライアントサイドのJavaScriptを使用してブラウザ内で100%ローカルに実行されます。機密性の高いクエリ認証情報、access_token の値、社内アナリティクスのペイロードが外部へ送信されることはありません。