URI包含HTTP動作動詞。我可以考慮這個API RESTful嗎？

Question

TutorialsPoint定義了以下方法REST風格的設計背景：

URI   HTTP  Body   Result 
----------------------------------------------------------------- 
listUsers  GET  empty   Show list of all the users 
addUser  POST  JSON string Add details of new user 
deleteUser DELETE JSON string Delete an existing user 
:id   GET  empty   Show details of a user 

我覺得這是一種誤導，因爲它不是REST風格。

一個RESTful設計是如下：

URI   HTTP  Body   Result 
---------------------------------------------------------------- 
users  GET  empty   Show list of all the users 
users  POST  JSON string Add details of new user 
users  DELETE empty   Delete an existing user 
users/:id GET  empty   Show details of a user 

是我的RESTful正確的理解？無論REST風格的定義

---

，在我看來，TutorialsPoint提出錯誤的設計，因爲deleteUser內部URL複製一個已經爲DELETE HTTP行動，這違反了Once And Only Once普遍原則傳遞的信息。

Answer 1

第一組端點是一個不好的設計爲一個REST API。這完全是關於RPC（並且DELETE請求不應該有有效載荷）。

第二組端點是以資源爲導向這就是你想要的REST API。 URI標識資源，HTTP方法表示對資源的操作。

---

但是REST架構變爲大有超越的URI的設計。

REST架構風格是協議無關，但它的設計在大部分時間HTTP協議。

RESTful應用程序中的基本概念是資源。資源可以有不同的表示。欲瞭解更多詳情，這answer可以是有幫助的。

要被認爲是REST風格，應用程序必須遵循一套在羅伊·托馬斯Fielding的論文的chapter 5定義的約束：

• Client-server
• Stateless
• Cache
• Uniform interface
  • 資源識別在
  • 資源表示
  • 自描述性消息
  • 超媒體
• Layered system
• Code-on-demand

Answer 2

是你的理解是正確的。該教程是誤導性的。