エージェント向け Polysh を早期アクセスで提供中。コーディングエージェントがデモを録画し、Polysh が仕上げます。 ウェイティングリストに登録 →

クエリパラメータービルダー

クエリパラメーターを正しくエンコードして追加した 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 は末尾に残っています。

クエリパラメータービルダーの使い方

  1. 「ベース URL」を入力するか、「例を使う」をクリックします。
  2. 「パラメーター」に 1 行に 1 つずつ name=value を書きます。「その他のオプション」では「同じ名前がすでにある場合」の動作と、「値はすでに URL エンコード済み」かどうかを設定できます。
  3. 「コピー」をクリックします。

知っておきたいこと

  • 置き換えたパラメーターは元の位置に残ります。同じ名前が複数回あった場合は、繰り返し分が削除され、最初の位置だけが残ります。
  • = のない行は、?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 文字程度までにしてください。それを超えると、途中で切り捨てたりエラーを返したりするシステムがあります。