SwaggerEditor基本使用

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

(1)每一个URI代表一种资源;

(2)客户端和服务器之间,传递这种资源的某种表现层;

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

然而编写接口时需要用到<strong><em>Swagger</em></strong>,它是一个简单但功能强大的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错误