HTTPに新しいMethod! QUERY RFC10008

#03 札幌開催：はじめてのIT勉強会 in 札幌(2026)【オフライン開催】で使用した資料です。

Transcript

1. HTTPに新しいMethod! QUERY 2026-06-25 #03 札幌開催：はじめてのIT勉強会 in 札 幌(2026)【オフライン開催】 宮本直幸@MSprzk 1
2. 2 $ cat profile.service [Unit] Description=Self Introduction After=network.target [Profile] Name="Miyamoto Naoyuki" Twitter="@Msprzk" Affiliation=" 北海道情報大学2 年" Interest="Network","Security","WebRTC"
3. 今日話すこと HTTPメソッドとは何か 検索APIで GET がつらくなる場面 POST で検索すると何が気になるか 新しい QUERY メソッドの考え方 curlで実際に投げてみる 3
4. HTTPメソッドとは HTTPメソッド → このリクエストで何をしたいか を表す名前 e.g. GET , POST , PUT など 4
5. たとえばGET GET /items?q=banana&tag=fresh&limit=10 GET は、 「データを取ってくる」ためのメソッド 検索結果を取るだけなら、GET は自然 5
6. GETで困ること 検索条件が増えると、URLがどんどん長くなる! キーワード タグ 表示件数 並び順 期間 除外したい条件 6
7. bodyとは HTTPリクエストには、URLとは別に「中身」を入れられる → body と呼ぶ POST /items/search Content-Type: application/json { "keyword": "banana", "tags": ["fresh", "sweet"], "limit": 10 } 7
8. POSTなら書きやすい POSTのメリット POST は body にJSONを書きやすいので、複雑な検索条件を表しやすい! POSTのデメリット 何かを送る 何かを作る データを変更する という印象が強いメソッドである 8
9. 検索で本当に言いたいこと 検索APIで言いたいのは、こういうこと↓ 条件は body に書きたい でも、やりたいことは「問い合わせ」 何回送ってもデータを壊さない HTTPメソッドを見ただけで、問い合わせだと伝えたい 9
10. そこでQUERY QUERY は、新しく定義されたHTTPメソッド ざっくり言うと、 body に条件を書ける、問い合わせ用のメソッド GET と POST の間にあった困りごとを埋める選択肢 10
11. GET / POST / QUERY GET データを取る URLに条件を書く 簡単な検索に向く POST bodyを使いやすい 複雑な条件を書きやすい 問い合わせかどうか伝わりにくい 11
12. QUERYの立ち位置 QUERY は、検索や問い合わせを表すためのメソッドです。 条件を body に書ける 何回送ってもデータを壊さない 「これは問い合わせです」と伝えやすい 複雑な検索APIを自然に書きやすい 12
13. デモ: curlで投げる curl は、ターミナルからHTTPリクエストを送る道具です。 curl -X QUERY http://localhost:8080/search \ -H 'Content-Type: application/json' \ -d '{ "keyword": "banana", "tags": ["fresh", "sweet"], "limit": 10 }' 13
14. レスポンス例 { "received_method": "QUERY", "message": "QUERY request received", "query": { "keyword": "banana", "tags": ["fresh", "sweet"], "limit": 10 }, "results": ["QUERY demo", "search result 1", "search result 2"] } 14
15. まとめ HTTPメソッドは「何をしたいか」を表す名前 GET は簡単な検索に向くが、条件が増えるとURLが長くなる POST は body を使えるが、問い合わせだと伝わりにくい QUERY は、body に条件を書ける問い合わせ用メソッド 15