Skip to content

swagger

Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。

什么是 RESTFul 风格

REST,即Representational State Transfer的缩写。直接翻译的意思是"表现层状态转化"。 它是一种互联网应用程序的API设计理念:URL定位资源,用HTTP动词(GET,POST,DELETE,PUT,HEAD)描述操作。

RESTful 架构服务器上每一种资源,比如一个文件,一张图片,一部电影,都有对应的URL地址,如果我们的客户端需要对服务器上的这个资源进行操作,就需要通过HTTP协议执行相应的动作来操作它,比如进行获取,更新,删除。

简单来说,就是URL地址中只包含名词表示资源,使用HTTP动词表示动作进行操作资源。

Other

Swagger与容易忽视的属性