我们很高兴地宣布在 SwaggerHub 中初步支持使用 OpenAPI 规范 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 文章、培训、教程等的电子邮件。订阅