Skip to content

MindSphere API 生命周期

MindSphere Web 服务 API 遵循既定生命周期。此生命周期既可以保证 API 相对于客户端的稳定性,又允许在现有 API 中引入新功能。

信息

强烈建议仅使用 MindSphere API 的正式功能。任何未明确指定的功能都可能随时变更,恕不另行通知。

主要版本生命周期阶段

下图显示了指定主要版本 API 的两个主要阶段:

在发布之后和弃用之前,在 MindSphere 生产环境中部署指定主要版本的 API 以供客户端使用。在 API 主要版本的生产阶段,对 API 进行向后兼容的更新(即次要更改)、错误修复和安全修复。一旦 API 主要版本弃用,就不会添加任何新功能。仅应用安全修复以及部分相关错误修复。

主要版本更新

发布新主要版本 API 后,之前的 API 主要版本即会被弃用。旧的主要版本仍可使用一段时间,以允许客户端转换到新的 API 主要版本。

image

弃用 API 实体

如果弃用 API 实体,则可使用 OpenAPI 规范中的 deprecated 属性或适当的描述来对此进行表述。同弃用的 API 一样,这些弃用的 API 实体仍然可用。弃用的 API 实体将在下一次对 API 进行重要更新时删除。


Last update: March 22, 2023