複数のデータを処理する時のAPIエンドポイントはどうするのか？

Question

Rest APIで単体のデータを作成、変更、削除する時は以下のようにしています。

POST /posts/:id/
PATCH /posts/:id
DELETE /posts/:id

では、複数のデータを一括作成、一括変更、一括削除する時のRest APIのエンドポイントはどのような形式のURIにすると良いのでしょうか？
ご教示頂ければ幸いです。

Answer 1

POST /posts/ikkatsu
PATCH /posts/ikkatsu
DELETE /posts/ikkatsu
のように、一括操作用の名前をつけて、idのリストはリクエストのボディに詰めて呼ぶのはどうでしょうか。

自分だったら、成功・失敗のやり取りが面倒だったり、途中経過を表示したかったりするので、そういったエンドポイントはつくらず、なるべくアプリ側から順番に呼ぶようにします。

自分が複数の処理を行うエンドポイントを作るケースを考えてみます。
まず、idを作るときにそのidはサーバー側にはないので、
POST /posts/:id
ではなくて
POST /posts
ですね。そこに、たとえばそれにコメントをつけるエンドポイント
POST /posts/:id/comments
があったとして、ついたコメントを全部消したかったら、
DELETE /posts/:id/comments/all
とします。
このように、複数のidを扱うエンドポイントを作る場合はidを列挙せずに済むようにして、処理も限定します。

「成功・失敗のやり取りが面倒」なのは「変なidが来た」とか、「idがあるがそれは消せない」とか、そういったエラーがそれぞれのidで起こった結果をどうやって返すのかとか、あんまりたくさんだとレスポンスが返ってこないとか、考えることが増えるからです。

Answer 2

Google APIの例ですが、zバッチリクエストのエントリポイントはhttps://www.googleapis.com/batchひとつで、そこにmultipart/mixedで各リクエストを乗っけたPOSTを投げる、というような構造を取っています（Qiita）。

Answer 3

トランザクション用のエンドポイントを作成してデータをロックできるようにします。