Swagger 工具

参考:官方工具列表

Swagger 衍生出来的一系列项目和工具,就可以做到生成各种格式的接口文档,生成多种语言的客户端和服务端的代码,以及在线接口调试页面等等。这样,如果按照新的开发模式,在开发新版本或者迭代版本的时候,只需要更新 Swagger 描述文件,就可以自动生成接口文档和客户端服务端代码,做到调用端代码、服务端代码以及接口文档的一致性。

Swagger UI

参考:官网

Swagger UI allows anyone — be it your development team or your end consumers — to visualize and interact with the API’s resources without having any of the implementation logic in place. It’s automatically generated from your OpenAPI (formerly known as Swagger) Specification, with the visual documentation making it easy for back end implementation and client side consumption.

Swagger UI 允许任何人(无论您是开发团队还是最终用户)都可以可视化 API 资源并与之交互,而无需任何实现逻辑。它是根据您的 OpenAPI(以前称为 Swagger)规范自动生成的,具有可视化文档,可简化后端实现和客户端使用。

Swagger Editor

参考:官网官方在线编辑器

在第一个完全专用于基于 OpenAPI 的 API 的开源编辑器上设计,描述和记录您的 API。 Swagger 编辑器是使用 OpenAPI 规范(以前称为 Swagger)的简单方法,它支持 Swagger 2.0 和 OpenAPI 3.0。

Swagger Codegen

参考:GitHub

Swagger Hub

参考:官网

类似于 Docker Hub,只不过可以存储 API 描述文件


最后修改 March 23, 2023: 整理,减少顶级目录 (8b75fa89)