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错误