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 开发更快更高效!