約2分で読めます
URLのクエリパラメータとは?仕組み・編集・デバッグの基本
クエリパラメータとは
クエリパラメータは、URLの末尾に ? を付けて続ける「キー=値」の組のことです。Webページやサーバーに対して「どんな条件で表示・処理してほしいか」を伝えるために使われます。
https://example.com/search?q=ノートPC&sort=price&page=2
この例では、q(検索語)、sort(並び順)、page(ページ番号)という3つのパラメータを渡しています。
構造のルール
| 記号 | 役割 |
|---|---|
? |
パスとクエリの区切り(最初の1つだけ) |
= |
キーと値の区切り |
& |
複数パラメータの連結 |
%xx |
URLエンコードされた文字(日本語・記号など) |
日本語やスペース、& などの記号はそのままURLに書けないため、%E3%83%8E のような形にURLエンコードされます。エンコード・デコードはURLエンコードツールで確認できます。
よく使われる場面
- 検索・絞り込み —
?category=books&in_stock=1のように一覧の条件を表現 - アクセス解析(UTM) —
utm_sourceなどで流入元を計測(UTMパラメータ作成ツール) - APIリクエスト — GETリクエストの条件指定
- ページの状態共有 — フィルタ条件込みのURLをそのまま共有できる
パラメータを編集・デバッグするには
長いURLからパラメータを目視で読み解くのは大変です。URLクエリ解析ツールを使えば、URLを貼り付けるだけでパラメータが表に分解され、値の追加・編集・削除をしてから新しいURLを組み立て直せます。APIの動作確認や、計測タグの修正に便利です。
扱う際の注意点
- 機密情報を載せない — クエリはブラウザ履歴・アクセスログ・リファラに残ります。パスワードやトークンをクエリに入れるのは避けましょう
- 順序や重複 — 同じキーを複数回付けられる仕様もあり、挙動はサーバー実装次第です
- エンコード忘れ — 値に
&や=を含む場合は必ずエンコードする
まとめ
- クエリパラメータは
?key=value&...でページに条件を渡す仕組み - 検索・UTM計測・APIなど用途は幅広い
- URLクエリ解析ツールなら分解・編集・再生成がすぐにできる
- 機密情報はクエリに載せないこと