REST服务 - 暴露非数据“操作”

问题描述 投票:14回答:3

我理解如何使用REST进行一般实体交互 - 使用URL名称映射到实体,使用HTTP谓词映射到这些实体上的操作。但是,更像RPC的“行动”被普遍接受的方式是什么?

例如,假设我想发送一个命令让设备重置?这里没有真正的“实体”,或者我做的事情就像POST到http://mydevice/device/reset?

web-services rest restful-url
3个回答
13
投票

/device/reset/system/reset还可以。

REST“设计模式”确实鼓励你不要使用任何动词..你可以这样做:

POST http://mydevice/system/state    
<stateType>RESET</stateType>

相关信息:


9
投票

我不认为使用POST就是这种情况。 “RESET动作”是一个幂等动作(如果你称之为n次,你将总是得到相同的结果),所以恕我直言你应该使用PUT调用而不是POST(因为POST不是幂等的)。

此外,当您放置资源时,您可以使用

PUT http://system
<device>
  <status>RESET</status>
</device>

要么

 PUT http://system/status/reset

但我认为第一个是“更安静”,因为你正在放置一个资源,而第二个你只是使用URL。


2
投票

我通常将实体命名为“system”或类似的东西。所以你做“/ system / reset”。你选择的设备也是如此。

但是,我通常认为这些类型的操作是更新,这将使用POST方法。所以我认为你对/ device / reset进行POST是正确的

© www.soinside.com 2019 - 2024. All rights reserved.