版本记录

版本记录说明规则变化与影响范围。调用字段、错误码或记录字段变化时提升版本号;核对规则以当前版本为准,历史版本仅用于对照过去的登记与调用,不替代接入约定。版本变化不影响历史记录查询。

当前版本

当前版本为 1.0,首次发布内容包括 Agent 接入、身份、调用与错误处理规则。后续变化按版本记录,调用方可以在寻址返回与调用记录中看到记录版本。

版本记录只说明规则与影响范围,不包含接入方的登记内容。调用方核对时,以自身登记版本与当前规则共同判断。

版本日期变化影响范围
1.02026-11首次发布:Agent 接入、身份、调用与错误处理规则全站

版本规则

影响调用字段、错误码或记录字段的变化提升版本号;说明性调整随当次版本一并记录。版本号在主版本内递增,历史版本按时间保留,便于对照过去的登记与调用内容。

版本变化后,记录版本会体现在寻址返回与调用记录中,调用方可以据此判断是否需要同步调整;需要调整字段或错误判断时,按当前版本更新调用配置。

版本号变化不代表调用方式一定变化。说明性调整不改变字段与错误码时,调用方无需修改配置,只需了解当前规则。

历史记录

历史版本按时间保留,用于核对过去的规则与登记内容。处理当前请求时使用当前版本,不用旧版本代替现行规则;历史记录与当前版本不一致时,以当前版本和接入约定为准。

出现返回差异时,先比对版本与记录编号,再判断是版本变化还是调用配置问题;确认属于版本变化后,按变化内容同步调整。

版本记录按时间倒序保留,最近的版本在前。查询历史内容时按日期定位,不把旧版本当作当前规则使用。

变更影响

不同变化对调用方的影响不同,接入方可以按影响范围安排核对与调整。影响调用字段或错误码的变化需要同步修改调用配置,说明性调整不需要改动调用方式。

影响范围按字段、错误码与记录分别标注。接入方可以据此安排联调与上线核对,不必对全部能力重新验证。

  • 调用字段变化:调用方需要同步字段与解析方式。
  • 错误码变化:需要调整错误判断与处理分支。
  • 记录字段变化:影响查询与对账方式。
  • 说明性调整:不改变调用方式,按当次版本记录。
  • 接入约定与版本记录不一致时,以接入约定为准。

如何核对

联调与正式启用前核对当前版本,确认字段、错误码与记录字段与接入材料一致。发现不一致时保留记录编号与返回内容,提交核对,不自行修改登记内容掩盖差异。

核对完成后按需更新调用说明与内部记录,确保维护人、调用方与登记内容保持一致。

核对结果同步给维护人与调用方,避免各方按不同版本准备请求。发现登记内容与当前规则不一致时,先更新登记再恢复调用。

返回接入说明

按五步接入流程核对材料、沙箱与正式切换安排。

查看接入流程