RESTful API在同一URI上的多个操作时

Question

POST /apple HTTP/1.1
Host: www.example.com

<different combination of arguments>

所以我的问题是:
在这个苹果案例中，如何设计一组优雅的RESTful API，让后端轻松处理它。

Answer 1

首先，尽量避免将HTTP方法与CRUD操作混为一谈。我相信这是REST混乱的主要来源。HTTP方法不能像那样干净地转换为CRUD操作。我在这里有一个详细的回答：

S3 REST API和POST方法

简言之。

null

GET /apple 

{"state": "whole",
 "self": "/apple"}

PUT /apple

{"state": "sliced"}

PATCH /apple

{"from_state": "whole", "to_state": "sliced"}

POST /apple

{"transition": "slice"}

• PUT版本是幂等的，所以您的客户可以在需要幂等的时候选择使用它。
• 修补程序版本保证客户端知道当前状态并尝试有效的转换。
• POST版本是最灵活的，您可以做任何您想做的事情，但需要详细记录。您不能简单地假设您的客户会知道该方法是如何工作的。

只要您的资源实现理解当apple.state被更改为其他内容时，它应该检测发生了什么更改并执行适当的转换，您就完全与协议解耦了。用了什么方法并不重要。

我相信这是最优雅的解决方案，并使从后端处理一切变得更容易。您可以实现您的对象，而不必太担心协议。只要对象可以在状态之间转换，它们就可以被任何可以影响这些转换的协议使用。