RESTful API - リソースコレクションの一部を削除しますか？

Question

私ができるDELETE単一のリソースのように：

// Removes group 12 from employee 46 
DELETE /employees/46/groups/12 

は、私はできDELETE全体のリソースコレクションのように：

// Removes all groups from employee 46 
DELETE /employees/46/groups 

私は、リソースのDELETE一部に適切なRESTfulな方法を探していますコレクション。

1. DELETE /employees/46/groups { ids: [12, 15, 32] }
2. DELETE /employees/46/groups?ids=12,15,32
3. DELETE /employees/46/groups/xx（シングル、しかし、3回それを呼び出す）

万一のクエリ文字列パラメータ（?ids=12,15,32は）のみGETで使用することが..？

リクエストボディ（{ ids: [12, 15, 32] }）は、常にPOST,PUTおよびDELETEと一緒に使用する必要がありますか？

これらの3つはすべて動作しますが、どちらが標準的な方法ですか。DELETEリソースコレクションの一部のみです。

Answer 1

JSON APIは、アプローチ番号1（DELETE /employees/46/groups）を使用しています。 RFC 7231 § 4.3.5は基本的には、本文中に送信されているものにかかわらず、ターゲットリソース（/employees/46/groups）全体が削除されると言っているので、それは怪しいものだと思います。しかし、others disagree。

私はDELETE /employees/46/groups?ids=12,15,32が、あなた自身のリソースとして削除したいグループのセットを考慮しているので、最も良いと思います。ハイパーメディアにリンクを張ることができます。後でGETをサポートすることができます（しかし、そうする必要はありません）。

いいえ、クエリ文字列で非GETリクエストを送信することは絶対にありません。クエリ文字列は、何らかの種類の "パラメータ"ではありません（それを扱うことはしばしば役に立ちます）が、リソースのURIの不可欠な部分です。実際には、DELETE /api.php?type=employee&id=46&groups=12,15,32を使用できますが、それでも完全にRESTfulです。 RESTの全体的なポイントは、URI（他のものの中でも）がクライアントに対して不透明であるべきことです。

ただし、クエリ文字列のアプローチでは、1つの要求で実際に多数のグループを削除する場合に問題が発生する可能性があります。その場合、最も簡単な方法はPOST /bulk-delete-groups RPC呼び出しです。 PATCH /employees/46/groupsも考えてください（ただし、最初にRFC 5789 errataとお読みください）。

Answer 2

ほとんどのAPIは、一度にリソースのコレクションを削除することはできませんが、それは次のように実体上の他の操作を実行することが可能です：

DELETE /employees?id=12,15,32 

または

DELETE /employees?id=12&id=15&id=32 

良い選択かもしれません削除のためにマークされたIDを含むカスタムJSONオブジェクトを送信します。