一對一的設計休息服務

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美分！