クエリパラメータービルダー
クエリパラメーターを正しくエンコードして追加した URL を作成できます。
- ブラウザ内で動作
- アップロード不要
- アカウント不要
ブラウザツールを読み込んでいます…
クエリパラメータービルダーでできること
?lang=de&ref=docs を手で追加すると、2 つ目の ? が入る、スペースがエンコードされずに残る、値の中の & で値が 2 つに分かれる、といった小さなミスが起こりがちです。ベース URL を貼り付け、1 行に 1 つずつパラメーターを書けば、ビルダーが正しい区切り文字とエンコードで URL につなげます。
同じ名前がすでにある場合、既定では新しい値で置き換えます。tag=a&tag=b のように同じキーを繰り返すには、「その他のオプション」で「もう 1 つ追加」を選んでください。next= や return_to= の値のような入れ子のリダイレクト URL は全体がエンコードされるため、その中の ? や & は値の中に収まります。
例
入力内容
ベース URL:https://example.com/search?sort=new#top パラメーター: q=screen recorder sort=popular
結果
https://example.com/search?sort=popular&q=screen%20recorder#top
sort=new は同じ位置で sort=popular に置き換えられ、その後ろに q が追加されました。スペースは %20 になり、#top は末尾に残っています。
クエリパラメータービルダーの使い方
- 「ベース URL」を入力するか、「例を使う」をクリックします。
- 「パラメーター」に 1 行に 1 つずつ name=value を書きます。「その他のオプション」では「同じ名前がすでにある場合」の動作と、「値はすでに URL エンコード済み」かどうかを設定できます。
- 「コピー」をクリックします。
知っておきたいこと
- 置き換えたパラメーターは元の位置に残ります。同じ名前が複数回あった場合は、繰り返し分が削除され、最初の位置だけが残ります。
- = のない行は、
?debugのような値のないパラメーターになります。サーバーが明示的な空の値を必要とする場合はdebug=と書いてください。 - 受け付けるのは http と https のアドレスだけなので、
myapp://openのようなアプリのリンクは使えません。 - アナリティクス用のタグには、標準の名前を入力して値を整える UTM ビルダーを使ってください。
クエリパラメータービルダーについてよくある質問
URL にパラメーターを追加するには?
パスの後に ? を付け、続けて name=value の組を & でつなぎます。例:/search?q=video&page=2。URL にすでに ? がある場合は、& で組を追加します。ビルダーは正しい区切り文字を選び、各値をエンコードします。
URL をクエリパラメーターとして渡すには?
内側の URL 全体をパーセントエンコードし、その :、/、?、& が外側の URL を壊さないようにします。ここでは next=https://example.com/a?b=1 のように普通の行として書けば、ビルダーがエンコードし、エンコードしたことを知らせます。
URL に同じパラメーターを 2 回入れられますか?
はい。多くのサーバーは tag=a&tag=b をリストとして読み取ります。両方残すには「同じ名前がすでにある場合」で「もう 1 つ追加」を選びます。既定の「置き換える」では、新しい値だけが残ります。
URL の長さに上限はありますか?
規格で決まった上限はありませんが、ブラウザ、サーバー、プロキシには実用上の上限があります。安全のため、リンクは 2,000 文字程度までにしてください。それを超えると、途中で切り捨てたりエラーを返したりするシステムがあります。