小编mik*_*ang的帖子

当前的Swagger规范声称Swagger用于描述和记录RESTful API.我认为情况并非如此,我认为Swagger对于简单描述HTTP API 非常有用,原因如下:

1. Swagger规范具有类似的元素Path,Definition但它们没有明确映射到REST数据元素,如资源,表示和媒体类型.我的想法是,为了有效地描述REST API,您应该被要求在API的上下文中定义显式REST数据元素.
2. 超链接不是Swagger规范中的第一类对象,因此超链接及其关键描述属性链接关系很容易被忽略.事实上,根本没有提到超链接.
3. HTTP路径位于前端和中心,这似乎明显违反了Fielding在其着名博客文章中提出的观点:

REST API不能定义固定资源名称或层次结构(客户端和服务器的明显耦合)

从本质上讲,我认为使用Swagger 2.0规范定义的API会导致您设计一个不受HATEOAS约束的API,这会违反REST.

这是正确的还是我错过了什么？