在 SwaggerHub 中引入 OpenAPI 3.0 代码生成

  2018 年 9 月 25 日

我们很高兴地宣布在 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 文章、培训、教程等的电子邮件。订阅