書き込み可能なリソース設計

Webを支える技術

16.9 設計のバランスより引用

 

・なるべくシンプルに保つ 設計が複雑になってきたら、機能が無駄に増えてきたら、1段階メタな視点で全体を考え直すこと。不要な機能や、やり方を変えることで削除できる機能があるかもしれない。全体をシンプルに保つことは、設計バランスを考えるうえで最も重要である

 

・困ったらリソースに戻って考える HTTPメソッドでは実現できない機能があると感じたら、それが独立した別リソースで代替できないかを考える。検索機能を実現するSEARCHメソッドをHTTPに追加するのではなく、「検索結果リソース」をGETする、と考えることが重要である

 

・本当に必要ならPOSTで何でもできる 更新にはPUTを用いるべきだとしても、たとえばバッチ処理のように複数リソースが対象となった時点で、PUTを使うのはあきらめてPOSTを用いるほうが賢明である