URL クエリビルダー

使い方

1. ベース URL を入力。既に `?` がある場合、ビルダーは `&` で残りを追加。
2. キー値の行を追加。チェックボックスをトグルで削除せずに含める / 除外。
3. サーバーが標準 URI エンコーディングを期待するか form エンコードを期待するかで `%20` / `+` を選ぶ。

よくある質問

スペースに `+` を使うのはいつ？

サーバーがクエリ文字列を `application/x-www-form-urlencoded` として扱うとき — 多くの古いフォームハンドラと CGI スクリプトがそう。モダンな REST API は通常どちらも受け入れるが、`application/json` POST 本文の安全なデフォルトは `%20`。

重複キーは許可される？

はい — ほとんどのサーバーは繰り返しキーを配列として扱う。一部は最後のものだけを保持；不明な場合は API ドキュメントを確認。

値の中で必ず符号化しなければならない文字は?

構造として読まれてしまうものです。アンパサンド、等号、空白、そして何よりシャープ記号です。シャープ以降はフラグメントであり、サーバーには送られません。符号化されていないシャープがひとつあるだけで、値の残りが要求から静かに切り落とされます。スラッシュとコロンはクエリ文字列の中では正当なのでそのままでも構いませんが、符号化しても害はありません。

パラメーターの順序は重要ですか?

サーバーにとっては重要ではありません。どの順に読んでもよいからです。しかしそれ以外のすべての場所では重要です。キャッシュやCDNはURLの文字列そのものを鍵にするので、同じパラメーターでも順序が違えば別のキャッシュ項目になりますし、URLに署名したり比較したりするもの――解析、署名付きリンク、重複排除――は別々の文字列として扱います。強制されなくても順序は固定しておきましょう。

関連ツール