一对一的设计休息服务

Question

场景：我们正在创建/设计REST服务以帮助我们配置系统（及其网络等），但是我们遇到了一些与设计此API有关的问题。我们想使用REST调用来配置系统的主机名/

挑战：因为大多数的API和设计准则与实体相关的名单，而不仅仅是一个单一的一个，我不能决定如何其余API应该看起来像。

目前我们正在使用类似的考虑：

• ​​
• PUT /system/0 {....}

问题：只有一个系统实体，因此感觉并不好，以确定这使用0，因为它只有一个。

是否有任何关于如何完成这个任务的REST指导？

Answer 1

实际上，REST并未强制使用特定格式的网址，您甚至可以使用像/569284d7-1b59-4343-92d4-90e8753bcbd7这样的网址，这没关系。在REST中，服务器通过状态更改来引导客户端，而不是关于客户端知道要访问的URL。

大多数Web API的是在一个CRUD风格创建，我们需要您的例子/system/0，资源的层次/system/1因为它更容易理解和执行（可能不总是REST风格取决于客户端的连接有多紧的网址，但它满足了大多数需求，所以人们选择这样做）。

所以我的建议是保持简单，不要过分想。使用/system/0就好，即使现在你只有一个系统。

只是我的2美分！