版本发布时间表

详细了解订单分析 API 的发展型模式和版本控制策略。

发展型模式

在快节奏的科技世界里，保持领先至关重要。这就是我们的分析数据 API 竭力满足您需求的原因。借助我们的发展型模式，您在新功能开发出来的第一时间就可以获得这些功能。告别漫长的新版本等待或繁琐的升级流程。

我们的最新功能支持无缝集成，确保您能继续使用当前版本且不会发生中断。这种方法可以帮您节省时间和成本。我们将及时告知您有关即将推出的功能的信息，以便您有效地制定计划。

版本控制策略

对于可能影响现有集成的重大更新或变更，我们会推出新版本，例如分析数据 API v2。

我们的 API 团队在开发下一个版本的同时，还管理着一个有效版本。新版本在启动后将成为有效版本，之前的版本则进入弃用阶段。弃用版本在一年内仍然可用，为过渡提供充足的时间。在此期间，我们仅会对弃用版本进行重要的安全更新。

术语

借助这些定义，更容易理解我们的版本发布时间表：

有效：分析数据 API 的当前版本，其中添加了非破坏性变更和功能。您可以根据自己的选择灵活地集成这些功能。

开发：即将推出的 API 版本，正在开发之中。

弃用：标记为弃用的版本表示该版本将在一年后停止使用。这段时间非常适合升级到最新的有效版本。

已停用：已停用版本无法通过该 API 访问。

非破坏性变更：这些更新可以在不影响现有设置的情况下进行集成。其中包括增加了新端点、可选查询参数和响应字段等内容。

非破坏性变更包括：

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

破坏性变更：可能需要变更集成的重大更新。其中包括删除了端点、引入了新的必需参数和变更了身份验证配置等。只有在 API 的新激活版本中才会引入破坏性变更。

破坏性变更包括：

• 删除了现有端点。
• 添加了新的必需查询参数。
• 在请求正文中添加了新的必需请求字段。
• 在请求中添加了新的必需标头。
• 可选请求参数变为了必需参数。
• 删除或重命名查询参数。
• 删除或重命名响应字段。
• 更改查询参数的类型。
• 更改请求正文中请求字段的类型。
• 为现有参数添加了新的确认要求。
• 删除或消除身份验证或授权配置。
• 删除或重命名枚举值。
• 在没有默认值的响应枚举中添加了新的值。