Swagger简单介绍

一句话介绍 Swagger

Swagger是一个接口文档生成工具，同时提供接口测试调用的辅助功能。

 

关于 Swagger

Swagger能成为最受欢迎的REST APIs文档生成工具之一，有如下几个缘由：

• mSwagger 能够生成一个具备互动性的API控制台，开发者能够用来快速学习和尝试API。
• Swagger 能够生成客户端SDK代码用于各类不一样的平台上的实现。
• Swagger 文件能够在许多不一样的平台上从代码注释中自动生成。
• Swagger 有一个强大的社区，里面有许多强悍的贡献者。
• Swagger 文档提供了一个方法，使咱们能够用指定的 JSON 或者 YAML 摘要来描述你的 API，包括了好比 names、order 等 API 信息。

你能够经过一个文本编辑器来编辑 Swagger 文件，或者你也能够从你的代码注释中自动生成。各类工具均可以使用 Swagger 文件来生成互动的 API 文档。

注意：用 Swagger 文件生成互动的 API 文档是最精简的，它展现了资源、参数、请求、响应。可是它不会提供你的API如何工做的其余任何一个细节。

Swagger 组件

Swagger 分红一些不一样的块。

• Swagger spec：这一块对元素的嵌套、命令等采用官方模式。若是你想要对 Swagger 文件手动编码，你必须很是熟悉 Swagger spec。

• Swagger editor：这是在线编辑器，用于验证你的 YML 格式的内容是否违反 Swagger spec 。YML 是一种句法，依赖于空格和嵌套。你须要对 YML 句法很熟悉才能很好的遵照 Swagger spec 规范。Swagger 编辑器会标出错误而且给你格式提醒（Swagger spec 文件可使用 JSON 或者 YAML 中的任意一种格式）

   

• Swagger-UI：这是一套 HTML/CSS/JS 框架用于解析遵照 Swagger spec 的 JSON 或 YML 文件，而且生成API文档的UI导航。它能够将你的规格文档转换成Swagger Petsotre-like UI。

• Swagger-codegen：这个工具能够为不一样的平台生成客户端 SDK（好比 Java、JavaScript、Python 等）。这些客户端代码帮助开发者在一个规范平台中整合 API ，而且提供了更多健壮的实现，可能包含了多尺度、线程，和其余重要的代码。SDK 是用于支持开发者使用 REST API 的工具。