当前版本
当前版本为 1.0,首次发布覆盖标识解析、记录版本、返回码和批量处理规则。接入方以此版本作为联调和验收的基线。
该版本适用于标识解析、记录版本查询、返回码说明和批量处理。接入方在联调、验收和内部文档中引用规则时,以该版本号标注。
| 版本 | 日期 | 变化 | 影响范围 |
|---|---|---|---|
| 1.0 | 2026-11 | 首次发布:标识解析、记录版本、返回码和批量处理规则 | 全站 |
版本规则
影响解析结果、返回码或记录字段的变化提升版本号;说明性调整随当次版本一并记录。版本号变化不自动改变已登记内容,登记变更仍按接入流程办理。
版本号用于标识规则集合,不用于标记单条记录。单条记录的版本由记录版本字段表示,两者含义不同。
影响范围
规则变化可能影响调用方对结果的判断。涉及返回码含义、字段结构或批量处理方式的变化,需要在接入沟通中确认影响范围。
影响范围按调用方、解析入口和记录字段分别标注;同一版本涉及多项变化时,按字段逐项核对,不合并判断。
- 解析结果字段变化:核对解析逻辑和台账字段。
- 返回码变化:更新排查手册和告警规则。
- 批量规则变化:调整文件拆分和重提方式。
- 说明性调整:同步文档,不改变调用逻辑。
- 接入协议变化:按协议确认后再调整调用。
历史记录
历史版本按时间保留。核对解析规则时使用当前版本,不使用旧版本代替现行规则。旧版本可用于追溯当时的规则背景,不用于指导当前调用。
已登记内容的变更不写入规则版本,而体现在记录版本。追溯一次具体请求时,使用记录编号查询解析记录。
查阅历史记录时,先确认对应日期和影响范围,再判断当时的规则是否适用于当前问题。历史版本不作为现行调用依据。
核对方式
版本变化以接入协议为准。对规则有疑问时,在接入沟通中说明涉及的标识、返回码和记录字段。
版本差异涉及返回码或字段时,先在测试环境复现,再调整生产环境的解析逻辑和告警阈值。变更完成后保留验证记录。
对接入协议条款有疑问时,先确认条款对应的版本,再判断当前调用是否需要调整。
- 接入联调前核对当前版本。
- 规则变化后核对差异和影响范围。
- 更新内部排查手册和告警规则。
- 在测试环境验证后再调整生产调用。
- 保留变更记录和验证结果。