版本发布时间表

详细了解我们的版本控制策略和发展型模式

发展型模式

创新就是锐意进取,一路领先。这就是我们设计 Rapid 3 的原因,帮助您保持前进步伐。

借助 Rapid 3 和发展型模式,您可以在功能就绪后立即下载使用。无需苦等六个月,等待新版本发布。也无需再花数小时的时间来升级每个新版本。

最新的功能版本不会破坏您的集成,因此在很长的一段时间里,您都可以放心使用 Rapid 3,从而节省时间和资金。我们还会介绍即将推出哪些功能,让您提前做好规划。

版本控制策略

如果我们准备上线较大功能或破坏性变更,会将它们发布到新版本中,例如 Rapid 4。

我们的 Rapid 技术团队会维护一个活动 API 版本,同时开发另一个版本。如果最新版本的开发结束,可以发布,就会成为活动版本,之前的版本则会标记为弃用版本。弃用版本在停用之前,还可以继续使用一年,让您有足够的时间迁移到最新最好的版本。在此期间,仅面向弃用版本推出重要的安全修复程序。

术语

下面的一些定义可帮助您了解我们的版本发布时间表:

活动:Rapid 的当前活动版本。我们可能会随时在活动版本中添加一些非破坏性变更功能,您可以决定是否集成这些功能。

开发:处于开发阶段且即将发布的 Rapid 版本。

弃用:如果一个版本被标记为弃用,就表示该版本将在一年后停止使用。这是升级到最新活动版本的绝佳时机。

已停用:一旦某个版本停用,就无法再通过 API 访问。

非破坏性变更:非破坏性变更是指可以随时添加到活动版本中且不会破坏集成的功能。

非破坏性变更包括:

  • 添加了新端点
  • 添加了新的可选查询参数
  • 在请求正文中添加了新的可选请求字段
  • 在请求中添加了新的可选标头
  • 强制性请求参数变为可选参数
  • 在响应中添加了新的字段
  • 在响应中添加了新的标头
  • 在请求枚举中添加了新的值
  • 在具有默认值的响应枚举中添加了新的值

破坏性变更:破坏性变更是较大的功能更新,可能会破坏您现有的集成。我们只会在新的 Rapid 活动版本中发布破坏性变更,因此您无需担心现有的集成。

破坏性变更包括

  • 删除了现有端点
  • 添加了新的必需查询参数
  • 在请求正文中添加了新的必需请求字段
  • 在请求中添加了新的必需标头
  • 可选请求参数变为了必需参数
  • 删除或重命名查询参数
  • 删除或重命名响应字段
  • 更改查询参数的类型
  • 更改请求正文中请求字段的类型
  • 为现有参数添加了新的验证要求
  • 删除或消除身份验证或授权配置
  • 删除或重命名枚举值
  • 在没有默认值的响应枚举中添加了新的值
您觉得这个页面有用吗?
我们该如何改进这些内容?
感谢您帮助我们改进 Developer Hub!