记录体系与三类记录
可信寻址的记录分为解析记录、变更记录和状态记录。解析记录保存一次请求的时间、调用方、结果与失败原因;变更记录保存端点、授权范围、联系人的调整;状态记录保存待核验、停用、恢复与注销的流转。三类记录通过记录编号与标识关联。停用、恢复与注销同时计入变更记录,状态记录按时间单列。
记录只反映请求与登记状态,不包含调用方业务正文。主体查看记录时看到的是登记侧信息,调用方看到的是自身请求的结果,两边按同一编号对齐,可以避免各查各的记录,也能减少对同一次请求的重复描述。
变更记录与状态记录容易混在一起。变更记录说明字段如何调整,状态记录说明标识是否可用。核对时先看状态,再看变更内容,顺序反了会把停用误判为字段差异,处理方向也会随之偏离。
核对前的信息准备
信息不完整时先补齐再核对。缺少记录编号的,只能按标识与时间范围查找,效率更低,也容易把两次请求混在一起,得出错误结论。
时间信息同样重要。调用方与平台可能处于不同时区,提交时注明时区,核对时按同一基准换算。只写日期不写时刻,遇到一天内多次请求时无法区分先后,版本比对也会失去意义。
- 完整标识,保留原始大小写与段间分隔符。
- 记录编号,解析或变更时由平台生成。
- 请求时间,精确到受理时使用的时区。
- 调用方标识与凭据所属主体。
- 当次返回的版本号、状态与端点。
- 与本次请求相关的变更事项和通知回执。
版本核对顺序
- 确认标识存在,记录状态为有效、停用或注销;停用与注销只核对历史记录,不返回端点。
- 用记录编号定位当次请求,读取返回的版本号。
- 把版本号与登记记录中的当前版本比对。
- 核对端点、授权范围与状态是否与当前版本一致。
- 差异落在字段层面时,逐字段记录差异内容。
- 确认差异是否来自未同步的节点,必要时等待同步后重新核对。
- 形成核对结论,注明依据的编号与版本。
- 把结论与原始输出一并归档,便于后续复核。
记录字段对照
| 字段 | 说明 | 核对用途 |
|---|---|---|
| 标识 | 本次请求对象 | 确认未截断、未改写 |
| 记录版本 | 当次返回的版本号 | 判断结果是否过期 |
| 端点 | 地址、协议、接入方式 | 确认调用目标 |
| 状态 | 有效、待核验、停用、注销 | 判断能否继续使用 |
| 记录编号 | 平台生成的唯一编号 | 定位请求与关联变更 |
| 失败原因 | 错误类型与说明 | 区分格式、权限与校验问题 |
| 调用方 | 发起请求的主体或节点 | 确认请求来源 |
| 变更记录 | 字段调整的前后版本 | 解释版本递增的原因 |
| 状态记录 | 停用、恢复与注销时间 | 判断结果能否继续使用 |
版本不一致的处理
版本落后于当前登记时,旧结果不再作为当前结果使用。调用方重新解析取得新版本,主体核对变更记录确认版本递增的原因。差异来自未同步时,等待节点同步后重新核对,不拼接两个版本的数据,也不把旧字段补进新结果。
处理差异时先通知受影响方,再修正本地配置。只改一侧,另一侧仍按旧版本请求,差异会反复出现。通知内容写明标识、编号、差异项和期望完成时间,避免接收方按不同理解处理。
- 端点差异:核对变更记录中的生效时间与当前端点。
- 授权差异:确认调用方是否在调整后的范围内。
- 状态差异:停用与注销的处理不同,先确认状态来源。
- 字段缺失:确认字段是否在授权范围内,不通过重复请求试探。
- 编号无法对应:按标识与时间范围重新查找,注明查找条件。
结论与留档
核对结论应写明标识、记录编号、比对版本、差异项和处理意见。结论用于内部复核与对外说明,不替代登记记录。涉及停用或注销的,结论中注明调用方是否已停止请求,以及本地配置是否清理。
留档保留原始输出,不只保留结论。原始输出包含返回码、版本和状态,后续出现新差异时可以重新比对。留档期限由主体按自身管理要求确定,平台记录按登记规则保存,两者用途不同,不宜互相替代。
对外说明时使用事实描述,不推测原因。写明核对范围、依据编号和已确认的差异,未确认的部分单独标注。这样既能让对方判断影响,也避免把内部推测当成结论,给后续处理留下反复。
常见问题
- 记录编号和请求编号有什么区别
- 记录编号由平台生成,用于定位一次解析或变更;请求编号由调用方生成,用于识别重复提交。核对时以记录编号为准。
- 旧版本记录还能查到吗
- 可以。历史版本按时间保留,用于核对旧请求,不作为当前办理依据。
- 版本不一致时可以先使用结果吗
- 不建议。先确认差异来源,重新解析取得当前版本后再使用。
- 记录中为什么没有业务内容
- 记录只保存核对所需字段,业务正文不进入解析链路。
- 同一标识同一天有多次请求,怎么区分
- 按记录编号区分,不用时间近似判断。时间只用于缩小范围,编号才对应唯一请求。
- 核对结论需要双方确认吗
- 涉及跨主体调用时,双方按同一记录编号各自核对,结论一致后再处理后续事项。