最近我花了一些时间和我的团队从 API 的角度来聊了 REST 的话题，同样也讨论了如何利用诸如违反了 REST 的最重要原则的 Swagger 技术去创建 API。正如我在讨论中说的，那就是 REST 风格不是用来描述 API。REST 描述了整个系统的架构特性，用于描述此该系统包含了所有哪些不同组成的部分。它尝试基于组件对系统提出系统级别的要求，甚至是对系统不起作用的一层。