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

是你的理解是正确的。该教程是误导性的。