GETとPOSTを超えて：新HTTP QUERYメソッド（RFC 10008）が現代APIに重要な理由

ほとんどの人がWebアプリケーションを構築してきた限り、データ取得オプションは常に建築的な妥協のように感じられてきました。

ほとんどの人がWebアプリケーションを構築してきた限り、データ取得オプションは常に建築的な妥協のように感じられてきました。

検索エンドポイント、複雑なフィルターパネル、または深くネストされたクエリを設計する際、私たちはフラストレーションを感じる岐路に立たされました：

GETを使用する： 安全で、冪等性があり、CDNやブラウザによって高度にキャッシュ可能です。しかし、巨大なJSONオブジェクトや複雑な検索条件をURLクエリ文字列にシリアライズすることを強制され、ブラウザの長さ制限、パラメータの読みにくさ、機密データがサーバーアクセスログに漏洩するリスクがあります。
POSTを使用する： リッチペイロードを安全に送信するためのクリーンなリクエストボディを提供します。しかし、POSTはデフォルトでセマンティックに非安全で非冪等性です。キャッシングレイヤー、ロードバランサー、リバースプロキシはそれをキャッシュすることを拒否し、自動的なネットワーク再試行は危険になります。

私たちは何十年もの間、これらの回避策に苦しんできました。しかし、Webアーキテクチャの風景は変化しています。IETFは新しいコアメソッドを正式に標準化しました：QUERY（RFC 10008）。

これが解決するもの、どのように動作するのか、現代のAPI設計でどのように考えるべきかを分解してみましょう。

`QUERY`が解決するコアの問題

本質的に、QUERYはクリーンでセマンティックなソリューションを導入します：「ボディ付きの安全なGET」として機能します。

これが歓迎すべき追加である理由を理解するために、公式仕様の下でコア検索メソッドがどのように比較されるかを見てみましょう：

プロパティ	`GET`	`QUERY`	`POST`
安全（読み取り専用）	はい	はい	潜在的にいいえ
冪等性（再試行可能）	はい	はい	潜在的にいいえ
リクエストボディを持つ	いいえ	はい	はい
キャッシュ可能	はい	はい	制限あり

アクションとデータを読み取るメカニズムを分離することで、QUERYはいくつかの永続的なエンジニアリングの障害に対処します：

URLの肥大化なし： 複雑なフィルター、データベースのようなクエリ言語、または深いグラフ構造はURI文字列から離れ、安全にリクエストボディに移動します。
デフォルトでプライバシー： 機密検索条件（個人属性、医療フィルター、またはプロプライエタリ検索パラメータなど）は、ブラウザ履歴、中間プロキシログ、サーバーアクセスログに露出されなくなります。
組み込み効率： QUERYは明示的にキャッシュ可能で安全であると宣言されているため、現代のキャッシングインフラストラクチャはそれをGETリクエストのように扱うことができ、条件付きリクエスト（基になるデータセットが変更されていない場合に304 Not Modifiedを返すなど）をサポートします。

データヘビーなクエリパターンとともに導入された最もエレガントな側面の一つは、Locationヘッダーを活用する概念です。

クライアントが複雑なQUERYペイロードを送信すると、サーバーは単に即時のJSON配列を返すだけでなく、その特定のクエリ結果を表す一時的または永続的なリソース識別子を指すLocationヘッダーで応答することもできます。

HTTP/1.1 200 OK
Content-Type: application/json
Location: /api/searches/9f8c-4a1b-8e3d

全画面モードに入る全画面モードを終了

サーバーが初期クエリの重い処理を完了すると、その後のポーリングやページネーションは、そのURIに対する軽量で標準的なGETリクエストを使用して実行できます。これにより、ステートフルなクエリ実行とステートレスなリソース取得の間のギャップを埋めます。

セマンティックな明確さはバックエンドアーキテクチャにとって大きな勝利ですが、新しいHTTPメソッドの展開には慎重なインフラストラクチャ計画が必要です：

エッジとプロキシのフィルタリング： 多くのレガシーWebアプリケーションファイアウォール（WAF）、企業ファイアウォール、リバースプロキシは認識されないHTTP動詞をブロックするようにハードコードされています。公開向けAPIでQUERYを採用する前に、APIゲートウェイとエッジインフラストラクチャが405 Method Not Allowedをスローするのではなく、カスタムメソッドを適切に処理することを確認してください。
キャッシュキーの生成： 従来のCDNは、リクエストパスとクエリ文字列のみを使用してキャッシュキーを構築し、リクエストボディを完全に無視します。リクエストボディのハッシュを含めるようにキャッシュキーロジックをカスタマイズせずにQUERY応答をキャッシュする場合、壊滅的なキャッシュ衝突の問題（ユーザーAがユーザーBの検索結果を受け取るなど）が発生するリスクがあります。
クライアントエコシステムのサポート： アップストリームHTTPクライアント、モバイルネットワークライブラリ、内部サービス間通信ツールがQUERY動詞とともにリクエストボディを送信することをサポートしていることを確認してください。

RFC 10008の導入により、データヘビーでプライバシーを意識した、スケーラブルなシステムを構築するためのよりクリーンな語彙が得られます。ついに、POSTを誤用したり、GETを構造的限界を超えて引き伸ばしたりすることなくデータをクエリするためのファーストクラスな市民ができました。

あなたのスタックでは、どのように現代のAPI設計に取り組んでいますか？今後の内部アーキテクチャでQUERYを評価する予定はありますか？以下のコメントで議論しましょう。👇

#WebDev #APIDesign #HTTP #SoftwareArchitecture #Backend #TechStandards

#Backend