ESET云控制台应用程序编程接口(API)
要理解变更如何影响你的集成,重要的是要区分 网关和它 所服务的 应用程序编程接口(API)类别 。
ESET Connect(网关)
ESET Connect 是一个由 ESET 完全管理的云托管网关。它作为以下ESET云服务客户端与后端服务之间的入口:
ESET Connect API 类别
网关提供访问特定 API 集的访问,这些 API 被按类别组织。
版本管理 |
每个 API 类别都有其独立的版本生命周期。这就是你在代码链接中指定的版本(例如 /v1/groups)。 |
冲击式 |
对 ESET Connect API 类别的更新可能会改变 API 调用。 |
生命周期结束策略 |
变更政策
如果变更被视为不破坏性,ESET可在未提前通知的情况下进行更改。
ESET会合理 地提前通知您有变更 ,并有足够时间适应这些变化。 |
破坏性变更 是指应用程序接口(API)的变更,可能需要对应用程序进行修改以避免干扰集成,或为了保持兼容性而需要进行修改。
以下是我们认为属于破坏性变更的一些变更示例:
•更改了响应格式,
•场地更名,
•字段已移除,
•数据类型变更,
•错误代码更改,
•业务逻辑的改变。
破坏性变更也可能由认证、权限范围、速率限制、传输/URL 变更及其他因素引起的。
不间断的变化 是指你可以根据自己的意愿和节奏适应而不被打扰的变化。
以下是一些我们认为 不 属于破坏性变更的变更示例:
•新场地补充道,
•新增可选参数,
•新增价值,
•提高速率限制,
•支持更多格式等。
过渡期
在过渡期内,随着新版本或功能替代产品推出后,旧版本仍可使用的时间段内,旧版本将继续提供一个明确的有限支持期。ESET将尽 合理努力 确保兼容性,并给予客户充足时间适应这些变化。
ESET Connect API 类别版本的 有限支持 从宣布日期开始,通常是在向终端客户公开公告的日期。ESET Connect API 类别版本将移至有限支持,并在整个期间持续提供,直至其服务终止日期。在有限支持期结束后,ESET Connect API 类别版本将不再可用。
版本控制规则
变更 |
任何包含破坏性变更的版本都会在文档中明确标注。 |
非断层变更 |
如果一个版本只包含非破坏性变更,API 类别版本保持不变。详情可见 ESET Connect 帮助文档。 |