快速开始

第一次使用寻址服务,需要准备主体信息、标识用途、目标地址和调用凭据。完成接入后,按标识发起一次解析,核对返回的目标地址、记录版本和校验状态,再决定是否进入业务调用。这一步同时用于确认凭据和解析入口是否正确。

接入前准备

接入前的准备决定后续解析是否顺畅。主体信息用于确认调用方身份,标识用途和调用方范围用于确定授权边界,目标地址和协议类型用于登记解析结果。

  • 主体名称和联系人信息。
  • 标识用途、调用方范围和服务场景。
  • 目标地址、协议类型和接入方式。
  • 调用凭据和回调地址(如需要)。
  • 需要保存的解析记录字段。

首次解析

首次解析只用于确认接入是否完成。返回结果包含目标地址、记录版本、校验状态和记录编号,不包含调用方业务正文。

  1. 提交标识和调用方信息。
  2. 系统校验标识格式和记录状态。
  3. 查询目标地址、记录版本和校验状态。
  4. 返回结果并写入解析记录。
  5. 调用方核对结果,确认目标地址和版本。

结果核对

核对结果时以登记内容和当前版本为准。任一字段不一致,先停止业务使用,再按表格中的处理方式修正。

字段核对内容不一致时
标识与登记时一致核对提交内容,检查是否截断
目标地址协议、主机和路径完整查看登记记录,提交地址变更
记录版本与当前登记版本一致重新解析,不使用旧结果
校验状态通过或失败校验失败时暂停使用结果
记录编号本次请求有唯一编号用编号查询解析记录

常见失败处理

处理失败时先看返回码,再判断问题出在请求、登记、权限还是校验环节。不同原因使用不同处理方式,避免把所有失败都当成网络问题反复重试。

  • 返回格式错误:核对标识是否截断、记录类型是否受支持。
  • 返回标识不存在:核对标识是否完整,确认是否已停用或注销,停止重复请求。
  • 返回校验失败:暂停使用结果,联系运营人员排查记录。
  • 返回无权限:检查凭据有效期和授权范围,不通过重复请求绕过限制。
  • 返回频率超限:按返回时间退避后重试,避免持续加压。

进入稳定调用

首次解析通过后,把目标地址、记录版本和记录编号纳入调用日志。解析结果会随登记变更而更新,不宜当作长期有效的配置;地址变更或授权范围调整后,记录版本会递增。

缓存时间由记录 TTL 决定。需要切换地址时,先缩短 TTL,等待旧缓存过期,再修改地址;不要在切换过程中同时修改 TTL 和目标地址。调用凭据按主体和用途签发,到期前完成更换。

首次联调建议只覆盖一个调用方和一个标识,确认凭据、解析入口与记录编号三者对应后,再扩大到其他系统。日志中同时保留请求时间和记录版本,出现差异时可以快速定位。

完成首次解析

查看解析命令,确认查询对象、记录类型和输出选项。

查看解析命令