HTTP検索条件、GETにするか？POSTにするか？ | フューチャー技術ブログ

はじめにTIG DXユニット 1真野です。 RESTfullとかRESTishな方針でWebA PIの横断検索を設計する際にチーム内で方針について議論したやり取りの備忘記事です。 注意としてB2C向けなWeb APIを提供するというよりは、主に企業間または企業内部で使われるようなAPIの設計のバイアスがあります。LSUDs（Large Set of Unknown Developers）かSSKDs（Small Set of Known Developers）で言えば、確実にSSKDs脳で記事が書かれています。 REST API広く使われているため日本語記事も多数です。実践RESTful HTTP - InfoQ や、0からREST APIについて調べてみた など良さそうな記事が沢山でてくるの読むと良いでしょう。一般的な設計方法はやや古いですがWeb API: The Good Parts

[tacamula]

最大長に問題ない限りGETだなぁ。タブの復帰時に検索条件外れるの不便。Searchメソッドには期待。

[kazutomo]

本文はAPI設計の話をしてる気がするけど、ブコメはブラウザでアクセスするページの話してる？

[newnakashima]

システムを長く運用していると「検索結果をURLで共有できるようにしろ！」という要望が来るんだよなあ。今までPOST前提で作ってた検索と並び替えを全部POSTとGET両対応にする作業つらすぎる

[mano-junki]

書きました！

[hylom]

冪等性のあるリクエストはGETにすべきだがGETのリクエストボディに対応していないツールが存在する問題。面倒臭いけど検索条件をPOST→検索条件を保存して対応するIDを変えす→IDを使ってGET、という手もあるっちゃある

[password1234]

URLの最大長はともかく「検索条件だけURLエンコードにするのは特殊すぎる」がよく理解できなかった。そのあたり大抵のクライアントライブラリが面倒見てくれると思うし、別にそんなに問題ではなくない？

[callirhoe08]

GETだなあ。この間最大長を確実に超えるものを作ることがあってPOSTだったけど、やっぱり使い勝手が悪かった。最大長を超えるものは設計が悪いと個人的に結論してる。

[hasegawatomoki]

キャッシュを使う時に気が抜けなくなるねえ。BCP56bis でもそこら辺書かれているので参考にすると良さそう。 section 4.5.1 。 https://twitter.com/kazuho/status/1346352661759578112

[strawberryhunter]

POSTで検索する代表的なサイトと言えば？私はkakaku.com。不動産もPOSTで検索するサイトが多い気がする。ブックマークしておけなくて不便。

[kiririmode]

REST APIで検索条件をBODYに持たせる場合はPOSTを選択するのが現時点では妥当な理由

[suika3417]

出来ることならGETにしたいなぁ、SEARCHが来るならそれに越したことはないな…

[tossy_yukky]

セマンティックなリクエストという意味でGETにしたい、かつどうしてもbodyに入れないといけない以外はURLパラメータにしておきたい派。 でもSEARCH出たらそっこーで変えたい。

[spark7]

GETでリクエストボディってありなのか

[z1h4784]

POSTでいいんじゃないかなあ。べき論で言ったらGETだけど、POSTにしてはならない理由はない。自分は極力GETとPOSTだけでやりましょう派。それが無難なので

[stefafafan]

検索結果を取得（GET）したいのだからGET1択だろう、と思いながら記事を開いてしまった

[greenbow]

個人的にはGETでリクエストボディあり、が意味的にもしっくりくるから好き。でもライブラリが対応してなかったりするので結局POSTに落ち着く。

[tohokuaiki]

APIでJSONのリクエストボディならPOSTじゃないかな。GETに無理くり詰めるのってなんか違う…

[ichiken7]

実装する立場からだとPOSTが自然だと思ってたけど、使う側からするとGETの方に思う

[ryu39]

記事とブコメ、双方の意見に納得。検索だけ考えるとPOSTだけど、ページ遷移やURLの共有を考えるとGET。現時点ではケースバイケースで考えるしかないのかな。

[odakaho]

終了 “AWSのCloudFrontはGETリクエストでリクエストボディを含むと403(Forbidden)を返す”

[ryuichi1208]

“GETにリクエストボディを指定することを禁じているというわけではなさそう” Elasticsearch以外で見たことないけどどれくらいあるんだろ

[punychan]

URLの共有をしたいならリクエストボディもだめでは？

[jojo800]

エンドユーザーが使うところはGET, それ以外はまぁ状況に応じてていいのでは

[kagehiens]

サーバー同士がやり取りする場合だと悩むよな。

[nunulk]

Web API では POST ありだなと思う（し、実際複雑な条件の場合は使うことがある。GET の場合は GET /resources で、POST の場合は POST /resources/search とか動詞つける

[aktkro]

打ち上げ花火的なネーミングと技術記事相性いいな

[umai_bow]

検索ボタンを押した時にPOSTで検索クエリレコードみたいなものを作成して、GETでそのIDを参照するとか…

[higgsino]

検索をPOSTにするとブラウザバックしたときにいちいちフォーム再送信の警告でるからうざいよ

[quabbin]

CDNにキャッシュさせたいかどうか…が基準になるかなぁ。

[tomonkyo]

POSTで受け取りつつ、検索結果とともに短縮URLをレスポンスして上げるのはどうだろう

[bootJP]

“SEARCH”

[shikiarai]

GETでどうにかなる実装以外はwebサービスの検索としては複雑すぎる。

[oakbow]

正直GETを使って検索条件をクエリストリングで保持する実装以外はエンドユーザのデメリットがでかすぎるんだけど、GETにリクエストボディって結論に至るのよく分からん

[tockri]

検索条件をJSONで送るのはなかなか大変そうだね。検索結果をURLで共有できないし

[t10471]

POSTで作ったこと無いけど、POSTにするとURL問題があるのか

[xlc]

副作用のない問い合わせはGETで行うのが普通でブラウザもそのように設計されている。POSTはHTMLを生成せず3xx応答するのが原則。まあWebDAVのようなAPIならこの限りではないけれどさ。