SwaggerHub 最新添加到其功能阵列中的是集成——一种通过连接到您现有工具集来驱动 API 生命周期的新方式。集成是可以添加到您的 API 定义中的一小段软件,以扩展 SwaggerHub 在您控制下的功能。它们可以在您的 API 规范的右侧找到,如下图所示

SwaggerHub 最初公开两个用户集成 - GitHub 同步和 Webhooks。
GitHub 同步
GitHub 同步允许生成的代码与您的 GitHub 存储库自动同步。这意味着,无需再进行下载、合并代码、复杂的配置或脚本编写。只需指定要生成的目标、GitHub 存储库信息以及文件/文件夹信息,您的客户端和服务器将始终与您的 Swagger 定义保持最新。客户端和服务器都可以推送到一个或多个存储库。Swagger 有 28 个不同的客户端和 13 个服务器目标,由 Swagger 社区的专家慷慨贡献。这意味着您可以开始提供客户端 SDK,而无需一支工程师团队来手工制作它们。并且由于您控制同步过程,您仍然可以在 SDK 中添加额外的逻辑,而无需担心您的更改会被生成器覆盖。

查看下面的简短截屏视频,了解 GitHub 同步的工作原理。您始终可以阅读功能文档以了解有关集成的更多信息。
Webhooks
Webhooks 允许您在您感兴趣的生命周期事件期间触发您自己的服务和集成。触发后,Swagger 定义将针对许多事件被推送到您定义的服务。无论是触发构建、单元测试、向您的开发人员发送电子邮件还是其他操作,您都可以通过 SwaggerHub Webhooks 设想自动化场景。

在上面的示例图像中,每次保存 API 版本时,都会将 HTTP POST 有效负载发送到 Jenkins。用户可以添加多个生命周期事件,并通过 HTTP POST 表单数据或 JSON 正文以 JSON 格式返回有效负载。阅读功能文档以了解更多信息。请关注未来更多的 SwaggerHub 集成,以帮助您快速高效地开发 API!