私の RESTful API がファイルとフォルダーを扱うとしましょう。これにより、ファイルとフォルダーの両方を作成および編集できます。
ファイルはフォルダーに属することができます。では、ファイルを別のフォルダに移動したいとしましょう。仕様および/または最も一般的なものによると、どれが最も適切でしょうか?
これは本当に簡単な答えではありませんが、ファイル リソースまたはフォルダー リソースを処理するのに、ファイルの移動アクションがより適切である必要があるのではないかと自問することになると思います。質問への回答が得られるまで、URI 構造についてあまり心配する必要はありません。
move アクションは 3 つのリソースに触れます。ファイル、元のフォルダー、および宛先フォルダー。元のフォルダーを推測できるため、クライアントは少なくともファイル URI と宛先フォルダー URI を知っている必要があります。両方のアプローチのケースが作成されていることがわかります。ファイル リソース表現 (POST のコンテンツ) は、移動が不要な場合は空と見なされる値として、新しい宛先フォルダーを示すことができます。フォルダー リソースは、POST に含まれるファイル表現がそのファイルをフォルダーに移動することを意味すると想定できます。あなたのビジネス プロセスにとって最も理にかなっているアプローチは、私が採用するものです。