

RestfulAPI を設計しております。  
URIはリソース的な記述が良いとされていますが、以下のようなケースの場合、どちらの記述がよいでしょうか？

対象：POSTメソッド

Aというリソースに対して、POSTメソッドで操作します。  
操作には、以下のようなものがあるとします。  
entry:新規追加  
update:指定したAのIDに対して、パラメータを更新  
copy:指定したAのIDを新規IDとして複製する  
それぞれの操作によって、リクエストボディに含めることができる必須パラメータ等が異なります。

操作については、リソースではないので、URIに含めない案１のほうが良いと思いますが、opキーのパラメータにより、その後のパラメータを判断しなくてはなりません。  
案２であると、操作によって、決められたパラメータがあるかをリクエストボディ内でチェックすればよく、また、URI毎の構文例として提示する際にもスッキリとドキュメント化できると考えています。

直感的に理解しやすいのは案２のような気がします。

案１：

[code]

    URI：
      http://{host}/A/
    リクエストボディ：
      {
         "op":"entry",
         ...
      }
    
[/code]

案２：

[code]

    URI：
      http://{host}/A/entry
    リクエストボディ：
      {
          ...
      }
    
[/code]


CC BY-SA 4.0
2022-02-24T02:05:03.783
86547
2022-02-24T02:05:03.783
32891
question
webapi
RestfulAPI URI記述：どちらのほうが最適でしょうか？