住宿 API 版本控制计划
详细了解我们的版本控制策略和发展型模式
发展型模式
创新就是锐意进取,一路领先。正因如此,我们设计了 Rapid API,让您永远无需中断步伐。
随着我们不断完善的架构,您可以在功能准备就绪后立即获得它们。无需苦等六个月,等待新版本发布。也无需再花数小时的时间来升级每个新版本。
我们最新的功能版本不会破坏您的集成,因此您可以更长时间地使用 Rapid,从而节省您的时间和金钱。我们还会介绍即将推出哪些功能,让您提前做好规划。
版本控制策略
当我们发布较大的功能或重大变更时,我们会将其发布到新版本中。
我们的技术团队维护着一个活跃版本的 API,另一个版本正在开发中。如果最新版本的开发结束,可以发布,就会成为有效版本,之前的版本则会标记为弃用版本。弃用版本在停用之前,还可以继续使用一年,让您有足够的时间迁移到最新最好的版本。在此期间,仅面向弃用版本推出重要的安全修复程序。
术语
下面的一些定义可帮助您了解我们的版本发布时间表:
活跃:Rapid API 的当前版本。我们可能会随时在有效版本中添加一些非破坏性变更功能,您可以决定是否集成这些功能。
开发:处于开发阶段且即将发布的 Rapid 版本。
弃用:当一个版本被标记为弃用时,表示该版本将在一年后不再可用。这是升级到最新有效版本的绝佳时机。
已停用:一旦某个版本停用,就无法再通过 API 访问。
非破坏性变更:非破坏性变更是指可以随时添加到有效版本中且不会破坏集成的功能。
非破坏性变更包括:
- 添加了新端点
- 添加了新的可选查询参数
- 在请求正文中添加了新的可选请求字段
- 在请求中添加了新的可选标头
- 强制性请求参数变为可选参数
- 在响应中添加了新的字段
- 在响应中添加了新的标头
- 在请求枚举中添加了新的值
- 在具有默认值的响应枚举中添加了新的值
破坏性变更:破坏性变更是较大的功能更新,可能会破坏您现有的集成。我们只会在新的 Rapid 有效版本中发布破坏性变更,因此您无需担心现有的集成。
破坏性变更包括:
- 删除了现有端点
- 添加了新的必需查询参数
- 在请求正文中添加了新的必需请求字段
- 在请求中添加了新的必需标头
- 可选请求参数变为了必需参数
- 删除或重命名查询参数
- 删除或重命名响应字段
- 更改查询参数的类型
- 更改请求正文中请求字段的类型
- 为现有参数添加了新的验证要求
- 删除或消除身份验证或授权配置
- 删除或重命名枚举值
- 在没有默认值的响应枚举中添加了新的值