当前版本
当前对外版本为 1.0,2026 年 11 月首次发布,覆盖网关架构、接口、调度、鉴权和审计规则。
1.0 覆盖网关的基本能力,包括模块划分、接口约定、转发条件、鉴权规则和审计字段。接入以该版本约定为基础。
版本号、日期和影响范围同时记录,便于按时间顺序核对。
当前版本说明以站点记录为准,接入细节以协议为准。
| 版本 | 日期 | 变化 | 影响范围 |
|---|---|---|---|
| 1.0 | 2026-11 | 首次发布:网关架构、接口、调度、鉴权和审计规则 | 全站 |
版本规则
版本号按影响范围提升。新增字段且保持向后兼容时提升次版本号;删除字段、改变字段含义或调整权限判断时提升主版本号。
错误码和调度规则的调整即使不改变字段,也按接口变化处理,避免调用方在无感知的情况下改变行为。
版本号只反映影响范围,不反映功能数量。一次变更可能同时涉及字段和文字,按影响最大的一项确定版本。
版本提升后,旧版本的字段含义按原版本解释,具体安排按接入约定执行。
变更分类
变更按内容归类,便于调用方判断是否需要调整自身系统。
分类用于判断影响面。接口字段变化通常需要调用方配合,文字调整不影响调用,转发与权限变化需要核对配置。
变更实施前完成影响评估,实施后核对结果,必要时按回退条件处理。
- 接口字段:请求、返回和错误结构。
- 转发规则:路由键、租户和信源状态。
- 权限判断:凭据类型、范围和期限。
- 说明文字:接口、调度和审计的表述调整。
历史记录
历史版本按时间保留。1.0 为首次对外发布版本,此前的内部调整不单独列示。
每次变更记录版本号、日期、变化内容和影响范围,便于按时间回溯。
记录内容保持简洁,说明变化和影响即可。需要了解细节时,按版本号查询接入沟通材料。
历史记录不删除,后续版本继续在原有记录上追加。
兼容与通知
接口变化以接入约定为准。涉及调用方改造的变更,在实施前完成沟通,并保留回退条件。
说明文字随版本同步更新,措辞调整不改变接口约定与字段含义。
兼容性判断以调用方实际使用字段为准。未使用的字段调整通常不影响调用,但仍按变更流程通知。
通知对象包括已登记的联系人,联系信息变更时及时更新。