工具与集成

您可以在此处找到服务于 Swagger 生态系统的库和框架列表。

主列表包含支持最新 Swagger 2.0 的工具。下方是尚未更新的工具列表。

Swagger 团队项目

这些项目由 Swagger 规范的作者创建。

名称	主要用途	描述
swagger-js	JavaScript 集成	一个针对 JavaScript 的 Swagger 实现。
swagger-ui	Swagger 描述渲染	一个不依赖任何外部库的 HTML、JavaScript 和 CSS 资源集合，可以从符合 Swagger 规范的 API 动态生成精美文档。
swagger-tools	Node.js 中间件	一个 Node.js 和浏览器模块，为 Swagger 提供验证及其他工具。
swagger-editor	Swagger 描述编辑	Swagger Editor 允许您在浏览器中编辑 YAML 格式的 API 规范并实时预览文档。之后可以生成有效的 Swagger JSON 描述，并与完整的 Swagger 工具链（代码生成、文档等）一起使用。
swagger-core	Java 集成	一个针对 Java/Scala 的 Swagger 实现。集成了 JAX-RS (Jersey, Resteasy, CXF...)、Servlets 和 Play Framework。
swagger-parser	Java 集成	一个用于 Java 中读取 Swagger 定义的解析器。
swagger-codegen	客户端/服务器端代码生成	一个模板驱动的引擎，通过解析您的 Swagger 文档来生成不同语言的客户端代码。
swagger-node	Node.js 集成	一个用于在 Node.js 中构建 API 的工具，集成了 Express, hapi, restify 和 Sails。
validator-badge	验证服务	将您的 Swagger 定义作为服务进行验证。

社区驱动的语言集成

本节中的所有工具都支持 Swagger 2.0。

Clojure

名称	描述
ring-swagger	使用 Prismatic Schema 作为数据模型，为 Clojure/Ring 提供 Swagger 实现
compojure-api	适用于 Compojure 的 Swagger
fnhouse-swagger	适用于 fnhouse 的 Swagger
pedestal-swagger	适用于 pedestal 的 Swagger
swagger1st	一个 Clojure/Ring 处理器，根据 Swagger 定义进行解析、验证和路由。
Friboo	一个用 Clojure 编写微服务的实用库，支持 Swagger 和 OAuth。

ColdFusion

名称	描述
swagger-sdk	此模块允许使用 Swagger/OpenAPI 规范进行软件开发，并利用 v3.0 OpenAPI 规范。
cbSwagger	此模块根据您配置的 ColdBox MVC 应用程序和模块路由自动生成 OpenAPI (fka Swagger) 文档。

C++

名称	描述
oatpp-swagger	用于 oat++ 应用程序的 Swagger-UI 集成。使用 OpenAPI 3.0.0 规范。

D

名称	描述
swaggerize	规范解析和结构、请求验证和处理器绑定。

Delphi

名称	描述
SwagDoc	SwagDoc 是一个 Delphi 库，用于为 Swagger Spec 2.0 版本生成 swagger.json 文件。使用 Swagger 2.0 为 Delphi 语言创建公共文档 REST API。

Erlang

名称	描述
cowboy-swagger	将符合 Swagger 规范的定义添加到您的 cowboy Web 服务器。可在 hex.pm 上获取。

Elixir

名称	描述
PhoenixSwagger	`PhoenixSwagger` 是一个为 Phoenix Web 框架提供 Swagger 集成的库。它为 Phoenix 控制器生成 Swagger 规范并验证请求。

Elm

名称	描述
swagger-to	`swagger-to` 从 Swagger 规范生成 Elm 客户端代码。

Gitlab

名称	描述
swagger-template	一个模板项目，可自动将您的 YAML 文件转换为 Swagger UI 文档。

Go

名称	描述
go-swagger	一个支持您使用 Swagger 进行 API 开发的工具包。
goa	goa 是一个用于在 Go 中构建 RESTful 微服务的框架，提供一流的 Swagger 支持。
grpc-gateway	从 gRPC protobuf 定义生成 REST 网关和 Swagger 定义。
swagger-to	`swagger-to` 从 Swagger 规范生成 Go 服务器代码。

Haskell

名称	描述
swagger2	在 Haskell 中表达 Swagger 2.0 模式
servant-swagger	Servant 是一个用于在 Haskell 中构建 RESTful 微服务的框架，通过 servant-swagger 提供一流的 Swagger 支持。

Java

名称	描述
assertj-swagger	assertj-swagger 是一个库，它将设计优先的 Swagger YAML 与实现优先的 Swagger JSON 输出（例如来自 springfox 的输出）进行比较。assertj-swagger 允许验证实现是否符合设计规范。
binder-swagger-java	binder-swagger-java 旨在帮助构建与 swagger.json 对应的 swagger 对象，并使其可通过 swagger ui 或其他 http 访问者访问。
dropwizard-swagger	一个封装了 Swagger-Core 的 Dropwizard 捆绑包。
elide	一个用于构建 JSON-API Web 服务并生成 Swagger 文档的框架。
jooby-swagger	将 jooby 应用程序导出为 Swagger Spec 2.0。
restlet-framework	Restlet Framework 扩展，支持从 Restlet API 和 JAX-API 应用程序自动生成 Swagger 2.0。
springfox	与 Spring MVC 集成，支持 Swagger 1.2 和 Swagger 2.0 规范。
swagger-codegen-maven-plugin	一个 Maven 构建插件，允许在构建过程中触发 codegen 项目以生成客户端等。
swagger2markup	Swagger2Markup 将 Swagger JSON 或 YAML 文件转换为 AsciiDoc 或 Markdown 文档，可与手写文档结合使用。AsciiDoc 文档可以转换为 HTML5、PDF 和 EPUB。Swagger2MarkupConverter 支持 Swagger 1.2 和 2.0 规范。
swagger2markup-gradle-plugin	一个 Swagger2Markup Gradle 插件，可将 Swagger JSON 或 YAML 文件转换为 AsciiDoc 或 Markdown 文档，可与手写文档结合使用。AsciiDoc 文档可以转换为 HTML5、PDF 和 EPUB。
swagger-maven-plugin	支持 Swagger Spec 2.0，与 JAX-RS 和 Spring MVC 项目集成，并在构建阶段轻松生成 `swagger.json` 和静态文档。
swagger-codegen-gradle-plugin	一个封装了 swagger-codegen 的 Gradle 插件。
swagger-request-validator	一个独立的库，用于根据 Swagger / OpenAPI 规范验证请求/响应交互。与框架无关，提供 WireMock、Rest Assured 和 Pact 适配器。
Swagger Brake CLI	一个带有 CLI 接口的库，用于检查两个 API 规范是否存在破坏性变更。
Swagger Brake Maven 插件	一个用于 Swagger Brake 的 Maven 插件。
Swagger Brake Gradle 插件	一个用于 Swagger Brake 的 Gradle 插件。

JavaScript

名称	描述
Swagger Parser	在 Node 和浏览器中解析、验证和解引用 JSON/YAML Swagger 规范。

Jolie

名称	描述
Jester - Jolie rEST routER	该工具集允许将现有 Jolie 服务部署为 REST 微服务。它生成可在 SwaggerUI 中使用的 Swagger 描述符。从现有 Swagger 描述符开始，它生成用于执行所有可用 API 的 Jolie 客户端存根。

Lua

名称	描述
lua-Spore	一个使用 Swagger 2.0 描述的通用 ReST 客户端。

TypeScript

名称	描述
NSwag	该工具集生成 TypeScript 客户端类和 DTO 接口，用于调用 Web 服务操作（支持 JQuery、AngularJS、Angular 2 等）。
swagger-to	`swagger-to` 从 Swagger 规范生成 Angular 2+ 客户端代码。

.NET

名称	描述
Swashbuckle	为您的 WebApi 添加 Swagger 支持。
Swashbuckle.AspNetCore	用于文档化基于 ASP.NET Core 构建的 API 的 Swagger 工具。
AutoRest	AutoRest 工具从 Swagger 规范生成用于访问 RESTful Web 服务的客户端库。
SwaggerProvider	适用于 Swagger 的 F# 类型提供程序
NSwag	该工具链从 Web API 控制器生成 Swagger 规范，并生成通过 C# 访问它们的客户端代码。
QSwag	适用于 .NET Core 的快速轻量级 Swagger 生成器
SwaggerWcf	为 WCF 服务生成 Swagger (2.0) 并提供 swagger-ui。
Nancy.Swagger	为 .Net Framework/Core/Standard 上的 Nancy 服务生成 Swagger。
Unchase OpenAPI (Swagger) 连接服务	Visual Studio 2017/2019 扩展，用于使用 NSwag 为 OpenAPI（前身为 Swagger API）Web 服务生成 C# (TypeScript) HttpClient（或 C# 控制器）代码。

Node.js

名称	描述
a127	a127 是一个用于在您的笔记本电脑上建模和构建 Node.js 中丰富的企业级 API 的工具包。a127 的核心是用于定义和描述 API 模型的 Swagger 2.0 规范。从 Swagger 模型中，您可以为您的 API 生成客户端、服务器和交互式文档。来自 @apigee。
api-spec-converter	一个用于将其他 API 规范格式（例如 I/O Docs 和 API Blueprint）转换为 Swagger 的工具。
blueoak-server	BlueOak Server 通过使用 Swagger API 驱动运行时行为来最大化其价值。
express-openapi	一个非侵入式的 Express OpenAPI 框架。
fleek-parser	一个基于 Koa.js 并与 Swagger 集成的简单解析器。
fleek-response	一个基于 Koa.js 并与 Swagger 集成的简单响应库。
fleek-router	一个基于 Koa.js 并与 Swagger 集成的简单路由器。
fleek-validator	一个基于 Koa.js 并与 Swagger 集成的简单验证器。
fury-adapter-swagger	Fury.js 提供了一个统一的 API 描述格式接口，如 API Blueprint 和 Swagger。`fury-adapter-swagger` 是一个 Swagger 适配器。
generator-swaggerize	来自 @PayPalDev 的 krakenjs/swaggerize 工具的 Yeoman 生成器。
got-swag	一个用于对支持 Swagger 的 API 运行自动化测试的 CLI 和库。支持猴子测试和自定义测试套件。
hapi-swaggered	一个 hapi.js 插件，用于根据 hapi 路由和 joi 模式生成符合 Swagger v2.0 规范的定义。
hippie-swagger	一个带有自动 Swagger 断言的 API 测试工具。
oas-nodegen	一个库，用于利用 Node.js 的脚本能力，从 OpenAPI 规范（前身为 Swagger）RESTful API 文档生成完全可定制的代码。
openapi-mock	一个 CLI 工具，用于根据 Swagger/OpenAPI JSON 或 YAML 规范文件启动模拟服务器。
pokemock	一个从任意 Swagger 文件生成的模拟服务器。导出一组可定制的 Express 中间件。
sails-swagger	一个 Sails.js 插件，可根据您的应用程序模型、控制器和路由生成 Swagger (v2.0) 文档。另请参阅 swagger.balderdash.io 获取 Sails 主题的 Swagger UI。
serverless_swagger	一个 Serverless 插件，可根据 Swagger 规范生成无服务器配置、API 网关事件和基本处理程序存根函数。
swagger-jsdoc	从任何 JavaScript 文件集获取 JSDoc 注释并生成 Swagger 规范文件，可由 Swagger UI 使用。也适用于 CLI。
swagger-mongodb	由 MongoDB 支持的轻量级 swagger-ui CRUD API
swagger-tools	各种适用于 JavaScript 的 Swagger 工具，包括 API/CLI（转换、验证等）和用于路由、验证、安全和 swagger-ui 的 Connect 中间件。
swaggerize-express	来自 @PayPalDev 的基于设计驱动的 RESTful API，结合 Swagger 和 Express。
swaggerize-hapi	来自 @PayPalDev 的基于设计驱动的 RESTful API，结合 Swagger 和 Hapi。
swagmock	Swagger API 模拟数据生成器。根据您的应用程序的 Swagger API 规范生成模拟请求和响应。示例
Swagger Express 中间件	用于 Express.js 的 Swagger 中间件和模拟。
Swagger Parser	在 Node 和浏览器中解析、验证和解引用 JSON/YAML Swagger 规范。
test2doc.js	从您的测试/规范自动生成 Swagger 规范。
koa-joi-swagger	使用 joi 模式为 koa 验证并生成 Swagger UI。
swagger-stats	基于 Swagger(OpenAPI) 规范的 API 遥测。在 Node.js 微服务中跟踪 API 调用并监控 API 性能、健康状况和使用统计。

Perl

名称	描述
Raisin	一个内置 Swagger 支持的框架。
MojoliciousPluginOpenAPI	生成 Mojolicious 路由和输入/输出验证规则。
OpenAPI::Client	用于用户代理代码的 Perl 生成器

PHP

名称	描述
cakephp-swagger	CakePHP 3.x 插件，使用 swagger-php 和 swagger-ui 为您的项目添加自动生成的 Swagger 2.0 文档。
Swagger-PHP	一个实现 swagger.io 规范的库，用于描述 Web 服务、操作/动作和模型，从而实现生成、消费和可视化 RESTful Web 服务的统一方式。
SwaggerAssertions	Swagger 2 测试断言，用于验证您的 API 请求和响应。
php-swaggerize-fastroute-library	一个从 swagger json 定义自动生成 FastRoute 的包。只要您使用控制器类，它就与 Lumen 兼容。
SwaggerGen	一个用于现有 PHP 源代码的 Swagger 2.0 文档生成器，使用可人工编写的 PHP-Documentor 风格注释，例如 `@rest\form int[0,123> age Age of the person`。内置预处理器。
Jane OpenAPI	根据 OpenAPI (Swagger) 规范生成 PHP 客户端 API（兼容 PSR7）。
gossi/swagger	一个用于操作 Swagger 规范的 PHP 库。
calcinai/strut	一个完整的 OpenAPI 操作库。允许规范的完全创建/加载、修改和序列化。
byjg/swagger-test	一套用于使用 PHPUnit 根据 Swagger 文档测试您的 REST 调用的工具。

Python

名称	描述
falsy	使用 FAL.S.Y，您可以将 falcon、swagger-ui、yml 一起使用，这使得编写 API 变得简单！
pyramid-swagger	方便的工具，用于在 Pyramid Web 应用程序中使用 Swagger 定义和验证您的接口。
pyramid-openapi3	根据 OpenAPI 3.0 文档验证 Pyramid 视图和响应。
flask-restplus	Flask-Restful 的辅助工具、语法糖和 Swagger 文档。
pyswagger	一个类型安全、动态、符合规范的 Swagger 客户端。
flex	Swagger 2.0 模式验证，以及用于验证任意请求/响应对象的工具。
Flasgger	一个 Flask 扩展，通过 docstrings 为任何视图提供 Swagger 2.0（内嵌 swagger UI）。
flask-swagger	一个通过 docstrings 中的 YAML 为 Flask 提取 Swagger 2.0 的工具。
bravado	支持同步和异步 HTTP 的 Swagger 2.0 客户端。
bravado-core	用于 Swagger 2.0 模式摄取、验证、请求/响应验证等的库。
swagger-spec-validator	用于验证 Swagger 1.2 和 2.0 模式的库。
swagger-py-codegen	从 Swagger 规范文档生成 Flask-RESTful 应用程序代码。
Connexion	一个基于 Flask 的 Swagger 优先 REST 框架，支持验证和 OAuth 2。
pecan-swagger	pecan 的部分 swagger 提取器。
swagger-parser	提供有关您的 Swagger 文件的有用信息。
swagger-tester	自动 Swagger API 测试器。
swagger-aggregator	将多个 Swagger API 聚合为一个。
swagger-stub	从 Swagger 文件生成一个存根。
bottle-swagger	Bottle Web 框架的 Swagger 集成。
prance	一个解析 JSON 引用的 Swagger 解析器。
spec-synthase	Spec-Synthase 是一个工具，通过从小 YAML 文件构建 Swagger 规范文件，帮助处理大型 Swagger 2.0 文件。
FastAPI	高性能、易于学习、快速编码、可用于生产。由 Starlette 和 Pydantic 提供支持。基于 OpenAPI 3。包含 Swagger UI 作为前端。全部使用 Python 3.6+ 类型声明请求参数、正文等。具有自动数据序列化、转换、验证和文档功能。
swagger-to	`swagger-to` 从 Swagger 规范生成带有类型注解的 Python 客户端代码（基于 `requests`）。

R

名称	描述
plumber	创建一个由 R 语言提供支持的 API，其默认 OpenAPI 文档由 `swagger` 提供。
swagger	从符合 'Swagger' 规范的 R API 动态生成文档。

Ruby

名称	描述
Apivore	一个基于 RSpec 的工具，用于根据其 Swagger 2.0 规范测试您的 API。
grape-swagger	为您的 Grape API 添加符合 Swagger 规范的文档。
MiniApivore	基于 MiniTest 的 Apivore gem 修订版，一个用于根据其 Swagger 2.0 规范测试您的 API 的工具。
oas_parser	一个 Ruby OpenAPI Spec 3 定义解析器。
swagger-blocks	为 Ruby 应用程序定义并提供实时更新的 Swagger JSON。
swagger_engine	将 Swagger-ui 作为可挂载的 Rails 引擎包含进来。
svelte	用于符合 Swagger 2.0 规范的 API 的动态 Ruby 客户端生成器。
rspec-rails-swagger	使用 RSpec 请求规范为 Rails 应用程序生成 Swagger 2.0 文档。测试结果可以作为响应示例捕获。
rswag	适用于 Rails API 的 Swagger 工具。直接从您的 rspec 集成测试生成精美的 API 文档，包括用于探索和测试操作的 UI。

Scala

名称	描述
sbt-swagger-codegen	模型、客户端和服务器代码生成作为 SBT 插件集成。从您的 Swagger 文件生成代码。	客户端和服务器依赖于 playframework。
play-swagger	一个插件，与 Play Framework 结合，使得以 Swagger API 规范作为单一事实来源构建 RESTful Web 服务变得容易。
Fintrospect	一个基于 Finagle 的 Web 框架，开箱即用地生成类型安全的端点 Swagger 文档，包括为模型描述生成 JSON-schema。
swagger-akka-http	支持为基于 akka-http 的应用程序生成 OpenAPI 文档。

Swift

名称	描述
SwagGen	一个 Swift 命令行工具，用于从 Swagger 规范生成客户端代码。内置支持 Swift 目标。

社区驱动的工具

这些是 Swagger 社区生成的第三方工具

名称	描述
APIs.guru	Web API 的维基百科。包含 OpenAPI（前身为 Swagger）2.0 格式的 REST API 规范目录。https://APIs.guru
API Spots	API Spots 项目是一个“人性化”工具的集合，适用于任何有兴趣发现、探索和与 API 交互而无需技术背景的人。
bootprint-swagger	一个用于从 Swagger 定义创建静态文档的工具，使用 Handlebars、LessCss 和 Bootstrap 实现可自定义的样式和模板。
Dredd	一个与语言无关的命令行工具，用于根据 API 后端实现验证 Swagger 文档。
ember-swagger-ui	一个 ember-cli 插件，用于快速轻松地将 swagger-ui 添加到您的 EmberJS 应用程序。
generator-openapi-repo	Yeoman 生成器，用于设置包含规范、文档（ReDoc + swagger-ui）以及使用 swagger-editor 进行实时编辑的 GitHub 仓库。
intellij-swagger	Swagger 插件帮助您在 IntelliJ IDEA 中轻松编辑 OpenAPI/Swagger 规范文件。
linter-swagger	用于 linting Swagger 规范的 Atom 包。
ReDoc	OpenAPI/Swagger 生成的 API 参考文档。演示
swagger-commander	即插即用的 Swagger API 命令行接口。
swagger-confluence	一个用于解析 Swagger 模式并将 API 文档发布到 Atlassian Confluence wiki 的工具。包括一个 Java 库、一个命令行执行器和一个 Gradle 插件。
swagger-diff	一个用于比较两个 Swagger 规范的命令行实用程序、RSpec 匹配器和 Ruby 库。
swagger-style-validator	一个可定制的样式验证器，用于确保您的 Swagger/OpenAPI 规范符合您组织的标准。
SwagDefGen	JSON 请求/响应模拟转换为 Swagger 定义的转换器。
vscode-apielements	一个 Visual Studio Code 扩展，它将为您的 Swagger 文档带来交互性！
ember-swagger-ui	一个 ember-cli 插件，用于快速轻松地将 swagger-ui 添加到您的 EmberJS 应用程序。
commandcar	强化版 cURL。从命令行调用任何 API。
SwagGen	一个 Swift 命令行工具，用于从 Swagger 规范生成客户端代码。
swagger-mock-validator	一个与语言无关的命令行工具，用于根据模拟文件（例如 Pact 文件）验证 Swagger 文档。
Spectacle	一个用于 OpenAPI/Swagger 2.0 的精美静态 HTML5 文档生成器。演示
Swagger-ui-themes	一个 CSS 主题集合，用于美化您的 Swagger 文档。
APIFuzzer	无需编写代码，即可使用您的 Swagger 定义对应用程序进行模糊测试。
swagger-to-flowtype	一个 CLI 工具，用于从给定的 Swagger 文件生成 Flow 的类型定义。
swagger_style	`swagger_style` 是 `swagger-to` 工具集的一部分，用于检查 Swagger 规范的样式（命名约定、描述等）。

早期 Swagger 版本的工具

以下工具尚未生成 Swagger 2.0。它们在此处列出，因为它们可能对用户仍有价值。欢迎为这些项目贡献力量，帮助它们升级到 Swagger 2.0！

Clojure

名称	描述
octohipster	一个用于 Clojure 的超媒体 REST HTTP API 库。

ColdFusion / CFML

名称	描述
swagger-docs-cfml	从 CFML (Railo) ReST 组件创建 Swagger 文档。

Eiffel

名称	描述
swagger	Eiffel 中的 Swagger 协议实现。

Go

名称	描述
go-restful	一个使用 Google Go 构建基于 REST 的 Web 服务的库。
Sashay	一个用于公开 Swagger 规范的 REST 服务的 Go 代码生成器。
beego	一个支持从注释自动生成 Swagger 规范的框架。
Swagger 规范生成器	一个 Swagger 规范自动生成器。不依赖任何框架。

Groovy

名称	描述
springfox	SpringFox Grails 集成库，为 Grails 3.x 生成 Swagger 规范文档。此处是一个演示应用程序，展示了该库的集成。
restapidoc	一个用于 Grails Web 应用程序框架的简单 RESTful API 文档插件。
swaggydoc	Grails 控制器的 Swagger 文档。[源代码]