
五步流程
解析按固定顺序处理。调用方提交标识和调用方信息,系统完成校验与授权判断后返回结果,并把本次请求写入记录。
解析节点按记录版本读取端点和授权范围,版本不一致时暂停返回,等待同步后再处理。五步按顺序执行,任一步失败即停止,不返回中间结果。
- 提交:调用方提交标识、调用方标识和所需的返回字段。
- 校验:检查标识格式、记录状态和请求字段是否完整。
- 授权:确认调用方是否在标识的授权范围内,以及请求字段是否可见。
- 返回:返回端点、版本、状态和权属摘要,不返回业务正文。
- 记录:保存解析时间、调用方、结果和失败原因。
- 使用:解析结果只在本次请求内有效,需要最新端点时重新解析。
返回字段
成功返回包含本次解析的基础信息。权属摘要按授权范围返回,未授权字段不出现。
| 字段 | 说明 | 是否必返 |
|---|---|---|
| 标识 | 本次解析的完整标识 | 是 |
| 记录版本 | 当前记录版本号 | 是 |
| 端点 | 服务地址、协议和接入方式 | 是 |
| 状态 | 有效、停用、注销或待核验 | 是 |
| 权属摘要 | 主体名称和授权范围 | 按授权返回 |
| 记录编号 | 本次解析的记录编号 | 是 |
成功与失败
解析成功说明标识存在、记录有效且调用方在授权范围内。解析失败分为格式错误、标识不存在、已停用、无权限、记录校验失败和字段不完整,不同错误对应不同处理方式。
- 标识不存在:停止请求,核对标识是否完整。
- 标识已停用:暂停调用,联系主体确认恢复时间。
- 无权限:检查调用方标识和授权范围,不修改请求重试。
- 校验失败:暂停使用结果,联系登记节点核对记录。
- 字段不完整:补齐字段后重新提交。
调用方注意事项
调用方只提交解析所需字段,不提交业务正文。解析结果不宜长期缓存,端点或版本变化后旧结果可能失效。
- 每次业务调用前确认记录版本,避免使用过期端点。
- 同一错误不连续重试,先按错误类型核对原因。
- 保存记录编号,便于后续核对请求和处理异常。
- 凭据按主体和用途使用,不跨主体共用。
- 解析结果按需取用,不把端点写入公开配置。
记录与复核
每次解析都会生成记录编号,记录包含标识、调用方、时间、结果和失败原因。主体或调用方可按记录编号核对当次请求,运营节点依据记录处理异常。
记录用于核对请求和处理异常,不用于保存业务正文。涉及权限调整的,按变更事项办理后再解析,不通过重复请求绕过授权范围。
记录编号按请求生成,调用方在排查时提供记录编号、请求时间和调用方标识,便于定位。记录只用于核对,不对外提供业务正文。