2.2.7. クエリ (Query)

2.2.7. クエリ (Query)

@query 派生コンポーネントは, HTTP リクエストメッセージのクエリコンポーネントを指す. コンポーネント値は, [URI] で定義される正規化済みクエリ文字列全体であり, 先頭の ? 文字を含む. 値は [URI] の 6.2.1 節の単純な文字列比較規則を用いて読み取られる. すなわち, パーセントエンコードされたオクテットはデコードされない.

例えば, 次のリクエストメッセージ:

GET /path?param=value&foo=bar&baz=bat%2Dman HTTP/1.1 Host: www.example.com

は次の @query コンポーネント値となる:

?param=value&foo=bar&baz=bat%2Dman

および次の署名ベース行となる:

"@query": ?param=value&foo=bar&baz=bat%2Dman

次のリクエストメッセージ:

POST /path?queryString HTTP/1.1 Host: www.example.com

は次の @query コンポーネント値となる:

?queryString

および次の署名ベース行となる:

"@query": ?queryString

空のパスコンポーネントを含めるのと同様に, 署名者は空のクエリコンポーネントを含めて, このコンポーネントがメッセージで使用されていないことを示してもよい (MAY). リクエストメッセージにクエリ文字列が存在しない場合, コンポーネント値は先頭の ? 文字のみである:

?

次の署名ベース行となる:

"@query": ?