我们很高兴宣布新的增强功能,这将使组织更容易编写 API 文档并在 SwaggerHub 中共享公共 API 文档。
用于编写 OAS 定义文档的全新可视化编辑器
您现在可以在 SwaggerHub 中编辑 API 信息和元数据,而无需直接在 YAML 编辑器中工作。
全新的可视化编辑体验非常适合那些可能不直接了解 YAML 语法,或者需要构建 OAS 定义中的重要详细信息(例如 API 信息(标题、描述、许可证、联系信息)或操作元数据(摘要、描述、标签))的技术编写人员。
在可视化编辑器中所做的更改将自动与 YAML 代码编辑器同步,并实时在 UI 视图中可视化。该编辑器还支持 markdown 语法,允许将不同的格式和样式应用于技术文档,而这些文档可能很难在 YAML 编辑器中描述。
注意: 这是 SwaggerHub 中可视化编辑器的第一个版本。将来,我们将添加增强的功能来描述端点、标头、正文等。
访问全新的可视化编辑器
要切换到可视化编辑器,请在 SwaggerHub 编辑器的侧边栏中单击“显示可视化编辑器”。如果光标位于 YAML 代码中的特定操作内,则可视化编辑器将打开该操作。

在左侧的“导航”面板中选择一个项目。如果“导航”面板被隐藏,请单击侧边栏中的“显示可视化编辑器”图标以显示它。

探索全新的可视化编辑器
将公司徽标和品牌添加到 Swagger UI 文档中
组织现在可以将自己的品牌添加到托管在 SwaggerHub 中的 API 文档中。新的可自定义文档功能非常适合那些利用 SwaggerHub 共享外部 API 文档的组织。
新功能允许组织上传其公司徽标以替换标准的 SwaggerHub 徽标,并自定义标头颜色以匹配其公司品牌。

文档品牌适用于团队和企业计划中的组织。
访问新的文档品牌功能
组织所有者可以在组织设置的“文档品牌”页面上配置品牌选项
- 单击您的用户名并选择“设置”。
- 切换到“我的组织”选项卡。
- 在左侧的侧边栏中选择“文档品牌”。

探索新的文档品牌功能
与 Azure DevOps Services 集成
新的 Azure DevOps Services 集成允许您将 API 定义、自动生成的服务器代码或客户端 SDK 与 Azure DevOps Services(以前称为 Visual Studio Team Services 或 VSTS)中的现有 Git 存储库同步。每次您在 SwaggerHub 中保存 API 时,集成都会更新指定存储库中的代码。
与 Azure DevOps Services 的集成是添加到 SwaggerHub 的最新源代码控制集成,以及现有的与 GitHub、GitLab 和 Bitbucket 的集成。
访问新的集成
- 在 SwaggerHub 编辑器中打开您的 OAS 2.0 或 OAS 3.0 定义。
- 如果 API 有多个版本,请选择要与 Azure DevOps Services 中的存储库同步的版本。

- 单击 API 名称以打开 API 信息面板。
- 在 API 信息面板中,切换到集成选项卡,然后单击添加新集成。

- 从集成列表中选择 Azure DevOps Services。
探索 Azure DevOps Services 集成
开始使用 SwaggerHub
所有这些最新更新都在 SwaggerHub 团队和企业计划中可用。 登录并亲自试用 或 立即开始您的免费试用。