RESTful API 和调用远程方法 (RPC)

Question

因此，我正在对 RESTful API 进行一些研究，并试图弄清如何在资源上调用方法（本质上是 RPC）。

因此，如果我想在资源（订单）上调用方法（取消），从目前所见，我可以通过以下两种方式之一来实现：

POST /api/1/orders/123/cancel { }

或

POST /api/1/orders/123 { 'action' : 'cancel' }

希望这是有道理的？

我个人更喜欢前者，你只需输入 url 并调用方法，后者需要一些额外的 POST 参数工作。该方法所需的任何参数都将放在 POST 中吗？

我猜第三个是通过做：

PATCH /api/1/orders/123 { 'state' : 'cancelled' }

但我试图将订单（对象）的字段和方法分开。

Answer 1

最好的选择是第四个，PATCH 将 resource 的状态字段设置为“取消”的订单

PATCH /api/1/orders/123 { 'status' : 'cancel' }

或许

PUT /api/1/orders/123/status cancel

后者的优点是非常容易链接到 html 表单并与它一起使用。