Swagger 框架永远地改变了软件格局,允许使用通用语言(OpenAPI 规范)描述 API,参与生命周期的每个人和机器都可以理解、工作和集成。
虽然规范是框架的核心,但它周围有一个完整的工具链来增强 API 开发过程。为更好地实施 Swagger 框架,最流行和最基本的工具是 Swagger 编辑器和 Swagger UI。
Swagger UI 使 OpenAPI 规范(以前的 Swagger 规范)焕发了生机,允许用户以易于阅读和理解的格式可视化 API 并与之交互。Swagger 编辑器是另一个流行的开源项目,是使用 OpenAPI 规范设计 API 的事实上的编辑器。Swagger 编辑器和 UI 共同成为设计、记录和可视化 RESTFul API 的标准工具。Swagger 编辑器和 UI 的组合每 3 秒钟下载一次。
现在,在上次重大更新两年后,这些工具的下一个版本终于来了。
Swagger 编辑器和 UI 中有什么新功能?
全新的 Swagger 编辑器和 UI 采纳了来自开发人员社区数万名成员的反馈,并且像它们的前身一样,完全是开源的。它们将速度和可靠性放在 API 设计和文档过程的最前沿。这些工具的尺寸已缩小了 80%,从而为设计具体、强大和长 API 带来了更敏捷的体验。它们还引入了可扩展性机制,允许用户完全自定义界面并在核心 Swagger 平台之上构建自己的功能。
全新的 Swagger 编辑器和 UI 已从头开始重新设计,将代码合并到一个统一的代码库中,这将使开放源代码项目的合作和贡献更容易。这种统一的体验为开发人员和最终用户建立了一个通用框架,以便使用 OpenAPI 规范设计、构建和使用 API。
最新版本的 Swagger 编辑器和 UI 为将来与 OpenAPI 规范 3.0的兼容性奠定了基础,该版本将于今年晚些时候发布。
如果您有任何疑问,可以访问我们的常见问题解答部分。
以下是特定项目的存储库
Swagger-UI:https://github.com/swagger-api/swagger-ui
Swagger-Editor:https://github.com/swagger-api/swagger-editor
Swagger 团队将于 3 月 30 日在旧金山 Mashape 总部举行的聚会上演示新的 Swagger 编辑器和 UI。了解更多信息。