URI 包含 HTTP 动作动词。我可以考虑这个 API RESTful 吗？

Question

TutorialsPoint 在 RESTful 设计的上下文中定义了以下方法：

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

我认为这是误导，因为它不是 RESTful。

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 的理解正确吗？

---

不管 RESTful 的定义如何，在我看来，TutorialsPoint 的设计是错误的，因为 URL 中的deleteUser 复制了已经作为DELETE HTTP 动作传递的信息，这违反了Once And Only Once 的普遍原则。

Answer 1

第一组端点对于 REST API 来说是一个糟糕的设计。都是关于 RPC 的（DELETE 请求不应该有负载）。

第二组端点是面向资源的，这就是您在 REST API 中想要的。 URI 标识资源，HTTP 方法表示对资源的操作。

---

但是 REST 架构远远超出了 URI 的设计。

REST 架构风格独立于协议，但大多数时候它是基于 HTTP 协议设计的。

RESTful 应用程序的基本概念是资源。资源可以有不同的表示。如需更多详细信息，此answer 可能会有所帮助。

要被视为 RESTful，应用程序必须遵循 Roy Thomas Fielding 的论文 chapter 5 中定义的一组约束：

• Client-server
• Stateless
• Cache
• Uniform interface
  • 资源识别
  • 资源表示
  • 自我描述的消息
  • 超媒体
• Layered system
• Code-on-demand

Answer 2

是的，您的理解是正确的。该教程具有误导性。