变更记录

信源网关的变更记录按版本倒序说明接口、调度、鉴权、审计和说明文字的变化。影响请求字段、错误码或权限判断的调整都会提升版本号,并在接入沟通中同步。记录用于回溯,也用于判断调用方是否需要调整。

当前版本

当前对外版本为 1.0,2026 年 11 月首次发布,覆盖网关架构、接口、调度、鉴权和审计规则。

1.0 覆盖网关的基本能力,包括模块划分、接口约定、转发条件、鉴权规则和审计字段。接入以该版本约定为基础。

版本号、日期和影响范围同时记录,便于按时间顺序核对。

当前版本说明以站点记录为准,接入细节以协议为准。

版本日期变化影响范围
1.02026-11首次发布:网关架构、接口、调度、鉴权和审计规则全站

版本规则

版本号按影响范围提升。新增字段且保持向后兼容时提升次版本号;删除字段、改变字段含义或调整权限判断时提升主版本号。

错误码和调度规则的调整即使不改变字段,也按接口变化处理,避免调用方在无感知的情况下改变行为。

版本号只反映影响范围,不反映功能数量。一次变更可能同时涉及字段和文字,按影响最大的一项确定版本。

版本提升后,旧版本的字段含义按原版本解释,具体安排按接入约定执行。

变更分类

变更按内容归类,便于调用方判断是否需要调整自身系统。

分类用于判断影响面。接口字段变化通常需要调用方配合,文字调整不影响调用,转发与权限变化需要核对配置。

变更实施前完成影响评估,实施后核对结果,必要时按回退条件处理。

  • 接口字段:请求、返回和错误结构。
  • 转发规则:路由键、租户和信源状态。
  • 权限判断:凭据类型、范围和期限。
  • 说明文字:接口、调度和审计的表述调整。

历史记录

历史版本按时间保留。1.0 为首次对外发布版本,此前的内部调整不单独列示。

每次变更记录版本号、日期、变化内容和影响范围,便于按时间回溯。

记录内容保持简洁,说明变化和影响即可。需要了解细节时,按版本号查询接入沟通材料。

历史记录不删除,后续版本继续在原有记录上追加。

兼容与通知

接口变化以接入约定为准。涉及调用方改造的变更,在实施前完成沟通,并保留回退条件。

说明文字随版本同步更新,措辞调整不改变接口约定与字段含义。

兼容性判断以调用方实际使用字段为准。未使用的字段调整通常不影响调用,但仍按变更流程通知。

通知对象包括已登记的联系人,联系信息变更时及时更新。

了解站点主体

查看建设主体、服务对象与能力边界。

查看关于