Swagger Editor(API开发工具)

　　Swagger Editor是一款API开发软件，可以帮助你在软件上设计API，当你在开发一个新项目的时候就可以利用这款软件生成API文档，允许您在浏览器中编辑YAML中的[Swagger API规范并实时预览文档，然后可以生成有效的Swagger JSON描述并与完整的Swagger工具一起使用，无论你是开发代码还是制作文档都很方便，该软件提供很多模块，例如dist模块是一个无依赖模块，包含在服务器端项目中提供Swagger-Editor所需的一切，或者无法解析npm模块依赖关系的Web项目swagger-editor是一个传统的npm模块，旨在用于能够解决依赖关系的JavaScript Web应用程序项目，每个模块都提供介绍，让用户在制作API的时候更简单！

软件功能

　　1.运行在任何环境

　　编辑器在任何开发环境中工作，无论是在本地还是在Web上。

　　2.智能反馈

　　在编写简洁的反馈和错误处理时，验证OAS遵从性的语法。

　　3.即时可视化

　　可视化地呈现API规范并与API交互，同时定义它。

　　4.智能自动完成

　　用智能和智能自动完成更快地编写语法。

　　5.完全可定制

　　易于配置和定制任何东西，从线间距到主题。

　　6.关于你的开发

　　在每个流行语言中为API生成服务器存根和客户端库。

软件特色

　　将Swagger-Editor的整个dist文件夹公开为一个无依赖的npm模块。

　　如果你想为你安装npm安装依赖项，请使用swagger-editor。

　　导入OpenAPI文档

　　Swagger Editor可以导入您的OpenAPI文档，该文档可以格式化为JSON或YAML。

　　导入文件

　　单击**选择文件**，然后选择导入。 您导入的文件必须是有效的JSON或YAML OpenAPI文档。 如果存在验证错误，Swagger Editor将提示您。

　　导入URL

　　将URL粘贴到OpenAPI文档。

　　拖放

　　只需将OpenAPI JSON或YAML文档拖放到Swagger Editor浏览器窗口即可。

使用方法

　　1.展开 pet 的 post 方法；

　　2.然后单击 Model Schema 中的黄色字体的 JSON。

　　3.这里用 JSON 填充了 body value。这里的 JSON 是你必须上传的，用于创建 pet 资源。

　　4.将第一个 id 标签的值修改一下（你必须保证 id 值都是唯一的，并且不能从 0 开始）。

　　5.将 name 标签的值修改一下（最好也要唯一，方便对比结果），以下是示例代码：

　　6.单击 Try it out! 按钮，查看响应：

使用说明

　　standalone是编辑器的独立预设 - 它添加了[editor.swagger.io]使用的一些功能：

　　- 带有Swagger品牌的Topbar

　　- URL /文件导入

　　- YAML转换触发器

　　- JSON / YAML导出

更新日志

　　您的代码引入了哪些类型的更改？在所有适用的框中放置一个`x`： - >

　　没有代码更改（`src /`未修改：对文档，CI，元数据等的更改）

　　依赖项更改（对`package.json`中依赖项的任何修改）

　　错误修复（修复问题的非破坏性修改）

　　改进（错误更改现有功能）

　　功能（增加功能的非破坏性更改）

　　正在对公共API（配置选项，系统API，主要UI更改等）进行更改。

　　正在改变私有API（Redux，组件道具，实用程序功能等）。

　　正在破坏对开发人员API的更改（npm脚本行为更改，新开发系统依赖关系等）。

　　自动化测试

　　我的更改不能或不需要测试。

　　我的更改可以并且应该通过单元和/或集成测试进行测试。

　　如果是以上：我已添加测试以涵盖我的更改。

　　如果是以上：我已经注意在我的测试中覆盖边缘情况。

　　所有新的和现有的测试都通过了。