将单个“状态”应用于资源的RESTful方式

时间:2015-04-29 09:02:21

标签: api rest architecture restful-url restful-architecture

假设我有一个名为wallet的资源,我想对进出的内容应用某种流量控制。我把这个流控制称为lock

由于某种原因,这个流量控制目前被称为lock我不喜欢,但我不能提出任何更好的命名。

在我的后端,仅通过更改布尔值无法应用锁定,这是一个复杂的转换,调用外部提供程序并使树具有不同的可能类型(状态),如all_locked,{ {1}},only_input或根本没有控制流(没有锁定)。

现在我的想法是拥有以下端点:

only_output(索引)

GET /wallets(自我)

GET /wallets/{id}(创建)

POST /wallets(申请锁定)

POST /wallets/{id}/lock(更新锁定类型)

PUT /wallets/{id}/lock(删除锁定)

这不是一个真正的动作,它既不是一个简单的属性,也可以成为资源的一部分。 DELETE /wallets/{id}/lock也不是独立的资源或实体。

我对这种API的命名和设计并不满意,但我不确定如何才能让它变得更好。 有些人认为,由于某些原因,这并不是一件容易的事:错误的命名(动词的使用),需要避免在宁静的API中采取行动,方法过于操作等等。

在那种情况下,应用这种锁会有什么好的RESTful方法?

0 个答案:

没有答案