批量解析

批量解析按行读取标识,逐条校验并返回结果。单条失败不影响其他标识,失败项单独列出。适合在地址迁移、台账核对和定期巡检时集中确认一批标识的当前状态。提交前先整理文件格式,提交后按行核对结果。

适用场景

当需要确认的标识达到一定数量,逐条手工查询容易遗漏,也不便于留存。批量解析把标识按行组织成文件,一次提交后按行返回结果,成功项和失败项都带行号。

批量解析不改变登记内容,只做查询。结果用于核对目标地址、记录版本和错误类型,不替代登记变更。

批量结果应归档,作为后续核对和问题反馈的依据。

提交前先确认文件编码与行数,行数异常时先修正文件再提交,避免结果相互覆盖。

输入格式

输入文件按行组织,每行一个完整标识。文件格式保持稳定,可以减少格式类失败。空行和以 # 开头的行不参与解析,可用于分隔和注释。

  • 每行一个完整标识,行首行尾不留空格。
  • 空行和以 # 开头的行不参与解析。
  • 单批数量以接入通知为准,超过上限时分批提交。
  • 文件使用 UTF-8 编码,扩展名不限。

结果结构

结果按输入行返回,便于定位问题。成功项保留目标地址和记录版本;失败项保留错误类型和记录编号。记录编号用于后续查询本次处理记录。

字段说明
行号对应输入文件中的行号
标识本次处理的完整标识
结果成功、失败或跳过
目标地址成功时返回的地址
记录版本当前记录版本
错误类型失败时返回的错误分类
记录编号本次处理的记录编号

失败处理

批量结果逐行返回,成功项与失败项分开列出。整批重提会重复处理已成功项,也会放大解析压力,因此先按错误类型分类再重提。

只重提失败行,并在重提文件中保留原行号或建立对应关系。失败原因没有查清前,不要连续提交同一批标识。

  • 格式错误:修正标识后重提。
  • 标识不存在:核对来源,不重复提交同一标识。
  • 校验失败:暂停使用结果,联系运营人员。
  • 无权限:检查调用方授权范围。

提交与复核

批量结果进入台账前,先核对记录版本。版本落后于当前登记的地址不应继续使用。

失败项处理后保留原行号,便于与台账逐条对应,避免漏项或重复更新。

批量结果与台账核对时,以标识和行号双重对应;同一标识在多行出现时,逐行保留结果,不合并处理。行号缺失时按标识顺序重新对齐,不凭数量推测。

  1. 从业务台账导出待查标识。
  2. 去重并检查行首行尾空格。
  3. 按单批上限拆分文件。
  4. 提交后保存结果文件与记录编号。
  5. 按错误类型修正失败项并单独重提。
  6. 汇总成功项的目标地址和记录版本,更新台账。

申请批量接入

说明标识数量、调用方范围和结果用途,按接入流程确认批量规则。

申请接入