SwaggerEditor基本使用

Posted 2021-03-07 caomusheng

项目开发用了RESTful架构，简单理解就是

（1）每一个URI代表一种资源；

（2）客户端和服务器之间，传递这种资源的某种表现层；

（3）客户端通过四个HTTP动词，对服务器端资源进行操作，实现"表现层状态转

然而编写接口时需要用到Swagger,它是一个简单但功能强大的API表达工具，是目前现有的最大API工具生态系统。使用Swagger生成API，我们可以得到交互式文档，自动生成代码的SDK以及API的发现特性等。

2 SwaggerEditor安装与启动

（1）下载 https://github.com/swagger-api/swaggereditor/releases/download/v2.10.4/swagger-editor.zip。

（2）解压swagger-editor,

（3）全局安装http-server(http-server是一个简单的零配置命令行http服务器)

npm install ‐g http‐server

　　

（4）启动swagger-editor 

http‐server swagger‐editor

　　

（5）浏览器打开： 

http://localhost:8080

　　注意：在启动cmd命令时，要在swagger-editor的父目录下运行，不然会出现not found错误