"激活"的RESTful URL

Question

我有一个资源（项目），可以激活和停用它。
为此，什么是最RESTful的URLendpoint？

现在我正在考虑/projects/:id/activate和/projects/:id/deactivate，但我认为这不是非常RESTful。
此外，我不确定使用什么HTTP方法。

你能提供一些指点吗？
谢谢！

Answer 1

我知道我有点晚了，但这可能对其他人有用。

您可以从操作中创建一个名词，并将其用作子资源：activate-

现在，您可以在此子资源上使用POST和DELETE。

例如：

POST /projects/:id/activation       <-- activate project
DELETE /projects/:id/activation     <-- deleting the activation = deactivate

这种模式可以很好地用于在某个对象的开/关状态之间切换的操作。

Answer 2

您可以只将请求发送到projects/{id}，并使用PATCH（当您更新现有对象时）动词，例如。

PATCH /projects/123

[
    { "op": "activate|deactivate", ... }
]

阅读更多：RESTAPI-使用实际示例与补丁进行比较

Answer 3

最传统的方法是通过POST到 /projects/： id，参数指示您是要激活还是停用或其他东西（总是为其他东西留出空间）。

请注意，RESTful URL应该引用对象（如项目），而不是操作。那么常用的方法就有了明确的含义：

• PUT：创建或替换东西
• 补丁：设置东西的属性
• POST：对东西执行操作
• GET：取回东西
• 删除：删除的东西