Skip to main content

介绍

在开发者平台中,版本功能允许开发者创建多个集成迭代,从而在不影响现有用户的情况下实验和实现新功能。每个集成可以拥有多个版本,但同一时间只能有一个版本处于公开状态。

版本为您带来以下优势:

  • 无缝用户体验:现有用户可以不受中断地继续使用服务,同时新功能正在测试和部署中。
  • 渐进式升级:开发者可以分阶段推出新功能,从而在全面部署前进行彻底测试和收集反馈。
  • 版本管理:开发者可以采用结构化的方法,将用户迁移到更新版本,并在适用时弃用旧版本。

在平台 UI 中管理版本

要管理您的版本:

  1. 登录 平台 UI
  2. 选择您的 集成
  3. 在左侧侧边栏的 管理 部分,点击 版本

此页面会显示集成所有版本的列表,包括每个版本的状态、活跃用户数和活跃 Zap 数。对于公开集成,还会显示在推广新版本时输入的变更日志。

Platform UI vs CLI comparison

了解更多信息:

在平台 CLI 中管理版本

使用平台 CLI 创建的集成无法在平台 UI 中编辑,但您可以在平台 UI 中查看可用版本。您也可以运行 zapier versions 命令,在本地终端中查看相同信息。

如果我被阻止推广或迁移集成版本,该怎么办?

Zapier 可能会修复您的集成中的错误或添加新功能,并将其作为新集成版本发布。

如果 Zapier 已对您拥有的集成版本进行了更改,在您通过运行 zapier pull 更新本地文件之前,您将无法执行以下操作:

  • 将更改推送到已推广的版本
  • 推广新版本
  • 从一个版本迁移到另一个版本

运行 zapier pull 来更新本地文件至最新版本,并移除这些限制。任何破坏性的文件更改会在继续前提示您进行确认。

谁可以查看您的版本?

对于公开集成(这些集成可以在 Zap 编辑器或应用目录中搜索),用户在 Zap 编辑器中选择您的集成时,默认会使用当前公开版本。

对于 私有和公开集成,只有添加到集成中的团队成员,或是您特别共享私有版本的用户,才能看到这些版本。

我的用户如何识别新版本?

作为集成管理员,您在连接应用时始终可以看到所有集成版本,但最终用户应该只看到已发布的版本。

对于最终用户,公开版本只会显示集成的名称,而不会显示版本号。

对于私有集成,您可以通过用户电子邮件地址邀请他们加入新版本,或使用共享链接来邀请用户。

编辑版本

为了确保现有 Zap 能够持续稳定运行,开发者平台只允许您编辑处于私有状态且用户少于 5 个的版本。处于公开状态或用户超过 5 个的版本会显示警告消息,提示您改为克隆该版本。

Platform UI vs CLI comparison

在较新版本中进行集成更新时,请考虑对用户迁移和现有 Zap 的潜在影响。确保您的 API 和 Zapier 上的应用集成保持向后兼容至关重要,以避免对用户造成干扰

有没有办法批量更新 API 端点?

虽然平台 UI 中没有自动方式来实现这一点,但您可以考虑将集成迁移到 CLI,这可以简化更新端点的过程。您可以在此指南中找到有关如何将集成导出到平台 CLI 的更多信息:将集成导出到平台 CLI

如果您的主要关注点是更新基础 URL,您可以使用环境变量来托管基础 URL。然后,您可以使用 {{process.env.YOUR_KEY}} 来引用它,这可能会让未来的批量更新更容易。