全新的 Swagger Editor 和 UI 终于来了!

  2017年3月20日

Swagger 框架永久地改变了软件格局,它允许使用一种通用语言(OpenAPI 规范)来描述 API,使生命周期中涉及的所有人员和机器都能理解、使用和集成。

虽然规范是框架的核心,但围绕它有一整套工具链 旨在增强 API 开发过程。最流行和最基本的工具是 Swagger Editor 和 Swagger UI。

Swagger UI 赋予了 OpenAPI 规范(前身为 Swagger 规范)生命力,让用户能够以易于阅读和理解的格式可视化并与 API 交互。Swagger Editor 是另一个流行的开源项目,它是设计 OpenAPI 规范 API 的事实标准编辑器。Swagger Editor 和 UI 共同成为了设计、文档化和可视化 RESTful API 的标准工具。Swagger Editor 和 UI 的组合每 3 秒钟被下载一次。

现在,距离上一次重大更新两年后,这些工具的下一版本终于来了。

Swagger Editor 和 UI 有哪些新功能?

全新的 Swagger Editor 和 UI 吸取了来自数万名开发者社区成员的反馈,并且像它们的前身一样,是完全开源的。它们将速度和可靠性带到了 API 设计和文档过程的最前沿。工具的体积减小了 80%,这使得设计具体、健壮和长 API 的体验更加敏捷。它们还引入了可扩展性机制,允许用户完全自定义界面并在核心 Swagger 平台之上构建自己的功能。

全新的 Swagger Editor 和 UI 已从头开始重新设计,将代码合并到一个统一的代码库中,这将使开源项目的协作和贡献变得更加容易。这种统一的体验为开发者和最终用户设计、工程化和使用用 OpenAPI 规范编写的 API 建立了一个通用框架。

最新版本的 Swagger Editor 和 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 Editor 和 UI。了解更多。

© . All rights reserved.