当前版本
当前版本为 1.0,首次发布内容包括 Agent 接入、身份、调用与错误处理规则。后续变化按版本记录,调用方可以在寻址返回与调用记录中看到记录版本。
版本记录只说明规则与影响范围,不包含接入方的登记内容。调用方核对时,以自身登记版本与当前规则共同判断。
| 版本 | 日期 | 变化 | 影响范围 |
|---|---|---|---|
| 1.0 | 2026-11 | 首次发布:Agent 接入、身份、调用与错误处理规则 | 全站 |
版本规则
影响调用字段、错误码或记录字段的变化提升版本号;说明性调整随当次版本一并记录。版本号在主版本内递增,历史版本按时间保留,便于对照过去的登记与调用内容。
版本变化后,记录版本会体现在寻址返回与调用记录中,调用方可以据此判断是否需要同步调整;需要调整字段或错误判断时,按当前版本更新调用配置。
版本号变化不代表调用方式一定变化。说明性调整不改变字段与错误码时,调用方无需修改配置,只需了解当前规则。
历史记录
历史版本按时间保留,用于核对过去的规则与登记内容。处理当前请求时使用当前版本,不用旧版本代替现行规则;历史记录与当前版本不一致时,以当前版本和接入约定为准。
出现返回差异时,先比对版本与记录编号,再判断是版本变化还是调用配置问题;确认属于版本变化后,按变化内容同步调整。
版本记录按时间倒序保留,最近的版本在前。查询历史内容时按日期定位,不把旧版本当作当前规则使用。
变更影响
不同变化对调用方的影响不同,接入方可以按影响范围安排核对与调整。影响调用字段或错误码的变化需要同步修改调用配置,说明性调整不需要改动调用方式。
影响范围按字段、错误码与记录分别标注。接入方可以据此安排联调与上线核对,不必对全部能力重新验证。
- 调用字段变化:调用方需要同步字段与解析方式。
- 错误码变化:需要调整错误判断与处理分支。
- 记录字段变化:影响查询与对账方式。
- 说明性调整:不改变调用方式,按当次版本记录。
- 接入约定与版本记录不一致时,以接入约定为准。
如何核对
联调与正式启用前核对当前版本,确认字段、错误码与记录字段与接入材料一致。发现不一致时保留记录编号与返回内容,提交核对,不自行修改登记内容掩盖差异。
核对完成后按需更新调用说明与内部记录,确保维护人、调用方与登记内容保持一致。
核对结果同步给维护人与调用方,避免各方按不同版本准备请求。发现登记内容与当前规则不一致时,先更新登记再恢复调用。