解析流程

解析是按标识取得端点、版本、状态和权属信息的过程。一次解析分为提交、校验、授权、返回和记录五步,任一步不通过都会返回具体原因,调用方按返回结果决定是否发起业务请求,解析结果只在本次请求内有效。

夜间跨江大桥与城市灯光
标识与解析结果之间的对应关系,需要在记录中逐项核对

五步流程

解析按固定顺序处理。调用方提交标识和调用方信息,系统完成校验与授权判断后返回结果,并把本次请求写入记录。

解析节点按记录版本读取端点和授权范围,版本不一致时暂停返回,等待同步后再处理。五步按顺序执行,任一步失败即停止,不返回中间结果。

  1. 提交:调用方提交标识、调用方标识和所需的返回字段。
  2. 校验:检查标识格式、记录状态和请求字段是否完整。
  3. 授权:确认调用方是否在标识的授权范围内,以及请求字段是否可见。
  4. 返回:返回端点、版本、状态和权属摘要,不返回业务正文。
  5. 记录:保存解析时间、调用方、结果和失败原因。
  6. 使用:解析结果只在本次请求内有效,需要最新端点时重新解析。

返回字段

成功返回包含本次解析的基础信息。权属摘要按授权范围返回,未授权字段不出现。

字段说明是否必返
标识本次解析的完整标识是
记录版本当前记录版本号是
端点服务地址、协议和接入方式是
状态有效、停用、注销或待核验是
权属摘要主体名称和授权范围按授权返回
记录编号本次解析的记录编号是

成功与失败

解析成功说明标识存在、记录有效且调用方在授权范围内。解析失败分为格式错误、标识不存在、已停用、无权限、记录校验失败和字段不完整,不同错误对应不同处理方式。

  • 标识不存在:停止请求,核对标识是否完整。
  • 标识已停用:暂停调用,联系主体确认恢复时间。
  • 无权限:检查调用方标识和授权范围,不修改请求重试。
  • 校验失败:暂停使用结果,联系登记节点核对记录。
  • 字段不完整:补齐字段后重新提交。

调用方注意事项

调用方只提交解析所需字段,不提交业务正文。解析结果不宜长期缓存,端点或版本变化后旧结果可能失效。

  • 每次业务调用前确认记录版本,避免使用过期端点。
  • 同一错误不连续重试,先按错误类型核对原因。
  • 保存记录编号,便于后续核对请求和处理异常。
  • 凭据按主体和用途使用,不跨主体共用。
  • 解析结果按需取用,不把端点写入公开配置。

记录与复核

每次解析都会生成记录编号,记录包含标识、调用方、时间、结果和失败原因。主体或调用方可按记录编号核对当次请求,运营节点依据记录处理异常。

记录用于核对请求和处理异常,不用于保存业务正文。涉及权限调整的,按变更事项办理后再解析,不通过重复请求绕过授权范围。

记录编号按请求生成,调用方在排查时提供记录编号、请求时间和调用方标识,便于定位。记录只用于核对,不对外提供业务正文。

核对接口字段

请求字段、返回字段和错误分类在协议说明中统一约定,接入前可逐项核对。

查看协议约定