接入前准备
接入前的准备决定后续解析是否顺畅。主体信息用于确认调用方身份,标识用途和调用方范围用于确定授权边界,目标地址和协议类型用于登记解析结果。
- 主体名称和联系人信息。
- 标识用途、调用方范围和服务场景。
- 目标地址、协议类型和接入方式。
- 调用凭据和回调地址(如需要)。
- 需要保存的解析记录字段。
首次解析
首次解析只用于确认接入是否完成。返回结果包含目标地址、记录版本、校验状态和记录编号,不包含调用方业务正文。
- 提交标识和调用方信息。
- 系统校验标识格式和记录状态。
- 查询目标地址、记录版本和校验状态。
- 返回结果并写入解析记录。
- 调用方核对结果,确认目标地址和版本。
结果核对
核对结果时以登记内容和当前版本为准。任一字段不一致,先停止业务使用,再按表格中的处理方式修正。
| 字段 | 核对内容 | 不一致时 |
|---|---|---|
| 标识 | 与登记时一致 | 核对提交内容,检查是否截断 |
| 目标地址 | 协议、主机和路径完整 | 查看登记记录,提交地址变更 |
| 记录版本 | 与当前登记版本一致 | 重新解析,不使用旧结果 |
| 校验状态 | 通过或失败 | 校验失败时暂停使用结果 |
| 记录编号 | 本次请求有唯一编号 | 用编号查询解析记录 |
常见失败处理
处理失败时先看返回码,再判断问题出在请求、登记、权限还是校验环节。不同原因使用不同处理方式,避免把所有失败都当成网络问题反复重试。
- 返回格式错误:核对标识是否截断、记录类型是否受支持。
- 返回标识不存在:核对标识是否完整,确认是否已停用或注销,停止重复请求。
- 返回校验失败:暂停使用结果,联系运营人员排查记录。
- 返回无权限:检查凭据有效期和授权范围,不通过重复请求绕过限制。
- 返回频率超限:按返回时间退避后重试,避免持续加压。
进入稳定调用
首次解析通过后,把目标地址、记录版本和记录编号纳入调用日志。解析结果会随登记变更而更新,不宜当作长期有效的配置;地址变更或授权范围调整后,记录版本会递增。
缓存时间由记录 TTL 决定。需要切换地址时,先缩短 TTL,等待旧缓存过期,再修改地址;不要在切换过程中同时修改 TTL 和目标地址。调用凭据按主体和用途签发,到期前完成更换。
首次联调建议只覆盖一个调用方和一个标识,确认凭据、解析入口与记录编号三者对应后,再扩大到其他系统。日志中同时保留请求时间和记录版本,出现差异时可以快速定位。