クエリ文字列ビルダー

クエリ文字列ビルダーは、URLの疑問符の後に続く部分を作成および検査するのに役立ちます。この電卓は、検索ページ、API呼び出し、リダイレクト、署名付きURL、UTMキャンペーン、およびデバッグチケット用のクリーンなURLパラメータを必要とする開発者、マーケター、アナリスト、QAテスター、およびサポートチーム向けに構築されています。

クエリ文字列ビルダーの使い方

1. キーと値のペアがある場合は構築（Build）モード、すでにクエリ文字列またはURLがある場合はデコード（Decode）モードを選択します。
2. 構築モードでは、1行に1つのキーと値のペアを入力します。デコードモードでは、生のクエリ文字列または完全なURLを貼り付けます。
3. スペースをプラス記号にするかパーセントエンコードされたスペースにするかを選択し、重複するキーの表現方法を選択します。
4. 「クエリ文字列を構築」または「クエリ文字列をデコード」をクリックして、エンコードされたクエリ、デコードされたテーブル、警告、およびJSONプレビューを生成します。
5. コード、分析、API、またはリダイレクトで使用するために、クエリ文字列、疑問符付きバージョン、完全なURL、またはJSON表現をコピーします。

エンコードに関する注意点

クエリ文字列はコンパクトですが、細かなエンコードの選択が重要になります。スペースは、従来のフォームエンコードでは + として記述され、厳密なパーセントエンコードでは %20 として記述されます。&、=、?、# などの予約文字や非ASCII文字が、URLの構造ではなくデータそのものである場合は、パーセントエンコードする必要があります。

一般的な用途

• パラメータを誤って落とすことなく、UTMキャンペーンURLを作成する。
• tag=python&tag=web のように、重複するフィルタを使用するAPIリクエストをデバッグする。
• リダイレクトURL、OAuthスコープ、検索フィルタ、および分析タグをデコードする。
• 生のクエリ文字列をコードにコピーする前に、正規化されたクエリ文字列と比較する。

FAQ

URLクエリ文字列とは何ですか？
URLクエリ文字列は、URLの疑問符（?）以降の部分です。q=url+tools&page=2 のようにパラメータをキーと値のペアとして保存し、ブラウザ、サーバー、API、および分析ツールが小さな状態のデータを渡せるようにします。

スペースは + と %20 のどちらでエンコードすべきですか？
従来のHTMLフォームのクエリ文字列や多くのWebアプリケーションのパラメータにはプラス記号を使用します。厳密なパーセントエンコード、署名付きURL、APIの正規化、またはRFC 3986に密接に準拠するスタイルが必要な場合は %20 を使用します。

重複するクエリキーはどのように処理されますか？
重複するキーは、tag=one&tag=two のまま維持するか、tag[]=one&tag[]=two のようなブラケット配列に変換するか、あるいは tag[0]=one&tag[1]=two のようなインデックス付き配列に変換することができます。バックエンドのフレームワークによって好まれる規則が異なります。

デコーダに完全なURLを貼り付けることはできますか？
はい、可能です。デコーダは最初の疑問符の後の部分を抽出し、デコードの際には # の後のフラグメントを無視して、正規化されたクエリ文字列とデコードされたパラメータを表示します。

このツールは入力されたURLにリクエストを送信しますか？
いいえ、送信しません。このツールはテキストの構築、デコード、および表示のみを行います。入力されたURLにアクセスしたり、APIエンドポイントを呼び出したり、リモートサーバーがパラメータを受け入れるかどうかを検証したりすることはありません。

なぜ重複したパラメータや空のクエリパラメータが重要なのですか？
重複したキーや空の値は、サーバーがリクエストを解釈する方法を変える可能性があります。一部のフレームワークは重複を配列に変換し、一部は最初または最後の値のみを保持し、一部は空の値をパラメータが存在しない場合とは異なるものとして処理します。