タグのコレクションを表すリソースがあります。
/users/{username}/tags
API クライアントは、単一の HTTP 要求で一連のタグをこのコレクションに追加できる必要があります。これを行う方法を考え、最初に PUT または POST メソッドを使用することを考えました。ただし、これは、クライアントがそのコレクション内のタグを「設定」または「置換」していることを意味すると思います。そのコレクションに複数のタグを「追加」するための最も適切な HTTP メソッド (またはおそらく別のメカニズム) は何でしょうか?
{HTTP METHOD} /users/{username}/tags
リクエスト本文:
["short", "crazy", "funny"]
PUT /users/alganet/tagsすべてのタグを置き換えます。
POST /users/alganet/tagsさらにタグを追加します。
PATCHも使用できます。
PATCH /users/alganet/tagsタグを変更します。
可能なボディ:
{"POST":["rest", "php"], "DELETE":["soap"]}
Accept-Patch本文には、ヘッダーと一致する特定のパッチ形式が必要です。diff上記のサンプル本文はパッチのカスタム形式ですが、たとえばクリーンを使用できます。
リクエスト本文で送信されるタグが、置換ではなくコレクションへの追加を意図している場合は、POST をお勧めします。既存のタグを置き換える場合は、PUT を使用してください。