HTTP・Web 基礎4 択難易度 標準

ユーザー一覧を role=admin で絞り込む条件はどこに置くのが適切？

正答

1. GET のリクエスト本文に JSON として入れる
2. POST の本文に入れて /users へ送る
3. カスタムヘッダー X-Role: admin に入れる
4. GET のクエリ文字列（/users?role=admin）に置く

解説

取得条件（フィルタ・ソート・ページ番号など）は URL のクエリ文字列に置くのが慣例。URL だけで結果が決まるためブックマークやキャッシュが効き、ログからも何を取ったか分かる。GET に本文を付けることは仕様上禁止ではないが多くのサーバーやプロキシが無視するため使わない。POST は作成や副作用のある処理向けで、単なる検索に使うとキャッシュされず意図も伝わりにくい。認証情報ならヘッダーだが、検索条件をヘッダーに置く慣例は無い。

参考: developer.mozilla.org

restquery-stringget