我们很高兴地宣布 SwaggerHub 已初步支持使用 OpenAPI Specification 3.0 (OAS 3.0) 进行代码生成!
OAS 3.0 的代码生成一直是呼声最高的功能之一,因为越来越多的团队正从 Swagger 2.0 转向 OAS 3.0。本次初始版本是第一批支持的语言,并包含我们最常用的服务器存根和 SDK 选项,其中包括:
客户端 SDK
- html2
- java
- php
- swift3
- swift4
- typescript-angular
服务器存根
- jaxrs-di
- jaxrs-jersey
- jaxrs-resteasy
- jaxrs-resteasy-eap
您现在可以登录、打开新的或现有的 API 定义,并从定义编辑器右上角的“导出”菜单中访问代码生成选项。

结合 SwaggerHub 中从 2.0 迁移到 3.0 的强大转换功能,以及将任何这些 SDK 轻松推送到您选择的存储库系统的能力,我们现在让团队更容易在 OAS 3.0 上实现标准化,并充分利用最新版本 OpenAPI 规范的功能。除了支持 OAS 3.0 代码生成外,团队还增加了一些功能,以增强平台的用户体验。
自定义您的编辑器体验
我们收到了大量用户反馈,他们希望能够自定义 SwaggerHub 编辑器以获得更好的设计体验。编辑器经过了多项调整,以支持更好的可读性——从可变字体大小到更广泛的调色板选项。
我们还在幕后进行了一些调整,以解决用户提出的一些性能问题。
直观的评论通知
评论可用于沟通变更,并在整个设计和评审过程中跟踪问题。
评论功能的一个小改进是,用户现在可以看到有多少请求等待解决。您现在可以一目了然地看到未解决评论的数量,而无需通过搜索问题来了解哪些评论已得到处理。

样式验证器中新增规则
SwaggerHub 中的样式验证器工具通过从一系列可在 API 中强制执行的样式规则中进行选择,帮助团队标准化其 API 设计流程。我们已在样式验证器的规则列表中添加了三个新选项:
- 操作必须且只能有一个标签
- 操作必须至少有一个 2xx 响应
- 操作必须有一个默认响应
我们很高兴能将这些新特性和功能引入 SwaggerHub,并期待看到团队将如何围绕新版规范创造性地使用它们。
立即尝试这些新功能。 登录开始使用。SwaggerHub 新用户? 立即免费开始使用。
感谢阅读!正在寻找更多 API 资源?订阅 Swagger 新闻简报。每月接收包含我们最佳 API 文章、培训、教程等的电子邮件。 订阅