在 SwaggerHub 中介绍 OpenAPI 3.0 代码生成

  2018 年 9 月 25 日

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

© . All rights reserved.