HTTPにQUERYメソッドが追加されたのでRFC 10008を読んだ

Tue, 15 Sep 2026 10:03:58 +0900

HTTPにQUERYというメソッドが追加されていました。

2026年6月に公開されたRFC 10008「The HTTP QUERY Method」です。RFC 1008ではなく、ついに5桁へ入ったほうのRFC 10008です。

名前のとおりサーバーへ問い合わせるためのメソッドで、検索条件をリクエストボディへ入れられます。

それだけならPOSTでよさそうにも見えます。実際、複雑な検索APIをPOSTで作ることは珍しくありません。

QUERYが追加された理由は、ボディを送れることだけではなく、そのリクエストが読み取り専用で、同じ内容を再送してもよいとHTTP上で明示できるところにあります。

GETで検索すると条件がURIへ集まる

単純な検索なら、GETのクエリパラメーターで困りません。

GET /feed?q=foo&limit=10&sort=-published HTTP/1.1
Host: example.org

ただ、検索条件が増えて入れ子になったり、ある程度まとまった式を渡したくなったりすると、URIへ全部詰めるのが苦しくなります。

URIの長さについて、経路上にいるすべてのクライアント、プロキシ、CDN、サーバーが共有する単純な上限があるわけではありません。長いURIをどこまで通せるかは、実際の構成に左右されます。

JSONなどの構造をURIとして扱える形へエンコードする手間もあります。また、URIはアクセスログや履歴などへ残りやすいため、検索条件に扱いづらい情報が含まれる場合もあります。

ではGETにボディを付ければよいのかというと、これも標準的な解決にはなりません。

RFC 9110のGETの定義では、GETで受け取ったボディには一般的に定義された意味がありません。一部の実装ではrequest smugglingの可能性を理由に拒否されることもあり、事前に対応が分かっているオリジンサーバーへ直接送る場合を除いて、クライアントはGETにボディを付けるべきではないとされています。

送信元とアプリケーションが対応していても、途中にある別の実装まで同じ解釈をするとは限りません。

POSTならボディを送れる

GETで扱いづらい検索をPOSTにする方法は、すでに広く使われています。

POST /feed/search HTTP/1.1
Host: example.org
Content-Type: application/json

{
 "query": "foo",
 "limit": 10,
 "sort": "-published"
}

これなら複雑な条件をボディへ入れられます。

一方でPOSTは、リソースの作成や状態変更にも使われるメソッドです。そのPOSTが実際には読み取り専用だったとしても、HTTPの一般的な仕組みからは、安全で何度でも再送できる問い合わせなのか判断できません。

接続が切れたときに自動で再試行してよいのか、レスポンスを同じ問い合わせへ再利用してよいのかといった扱いには、そのAPI固有の知識が必要になります。

QUERYは、ここをHTTPメソッドの意味として定義します。

QUERYはボディを持つ安全で冪等なメソッド

QUERYで同じ検索を書くと、次のようになります。

QUERY /feed HTTP/1.1
Host: example.org
Content-Type: application/json
Accept: application/json

{
 "query": "foo",
 "limit": 10,
 "sort": "-published"
}

問い合わせの内容はリクエストボディとContent-Typeによって決まり、対象となる範囲はリクエスト先のリソースによって決まります。

GET、QUERY、POSTの違いを大まかに並べると次のようになります。

性質	GET	QUERY	POST
安全	はい	はい	保証されない
冪等	はい	はい	保証されない
リクエストボディの意味	定義されていない	問い合わせとして使う	対象リソース次第
レスポンスのキャッシュ	可能	可能	制限あり

ここでいう安全とは、クライアントが対象リソースの状態変更を要求しないという意味です。アクセスログが増える、計算資源を使う、問い合わせ結果を表す一時的なリソースをサーバーが作る、といった副作用まで禁止するものではありません。

Web API

HTTPにQUERYメソッドが追加されたのでRFC 10008を読んだ

GETで検索すると条件がURIへ集まる

POSTならボディを送れる

QUERYはボディを持つ安全で冪等なメソッド