服务范围
寻址面向企业技术负责人和运维人员,提供从标识到目标地址的基础解析服务。一次解析经过提交标识、状态校验、记录查询、返回结果四步,顺序固定;任何环节不通过,都会返回对应状态,不返回部分结果。
解析结果包含目标地址、记录版本和校验状态。调用方据此判断地址是否已更新、记录是否可信,再把结果用于业务调用。服务同时覆盖 DNS 信任锚、解析命令、返回码排查和批量解析,便于接入、联调和日常运维。
返回码用于区分不存在、无权限和校验失败,调用方可以按原因选择修正请求、补充权限或暂停使用结果。需要集中核对一批标识时,使用批量解析按行提交并保留结果文件。
- 标识解析:按登记标识返回当前目标地址。
- 记录版本查询:确认结果对应哪一版登记记录。
- 记录留痕:每次请求保留记录编号,便于回溯。
- DNS 信任锚校验:从预置公钥或摘要出发核验记录签名。
- 返回码说明:区分不存在、无权限和校验失败。
- 批量解析:按行读取标识,单条失败不影响其他标识。
适用对象
需要把业务系统中的对象、服务或资源映射到可核验地址的团队,适合使用寻址服务。调用方应能理解标识、记录版本和返回码,并具备基本的解析排障能力。
服务不要求调用方改造业务系统的主体结构,但需要在调用链路上增加一次解析和结果核对。对于地址经常变化、需要保留变更记录的场景,标识与目标地址分离更容易管理。
- 企业业务系统:统一维护外部服务地址,减少在多个系统中重复配置。
- 智能体开发方:在调用外部能力前确认目标地址和记录版本。
- 解析服务运维人员:按返回码定位失败环节,使用记录编号回溯请求。
- 安全与合规岗位:核对信任锚、校验状态和记录留痕。
接入流程
接入围绕主体、用途、地址和调用范围展开。材料齐全后进入核验,核验通过后分配解析入口和调用凭据,再按约定范围调用。
- 明确标识用途、服务场景和调用方范围。
- 准备主体名称、联系人、目标地址和协议类型。
- 登记标识与目标地址,确认接入方式。
- 获取调用凭据和解析入口,按区域与权限分配。
- 发起首次解析,核对目标地址、记录版本、校验状态和记录编号。
- 按配额调用并保存记录编号,异常时按返回码处理。
常见问题
首次解析只用于确认接入是否完成。结果异常时先核对标识和记录版本,再查记录编号对应的解析记录。
- 解析成功是否代表目标服务可用?
- 不代表。解析结果只说明标识对应的目标地址和记录版本,目标服务自身的业务可用性需要由调用方另行判断。
- 标识不存在时反复请求能否解决?
- 不能。先核对标识是否完整、大小写是否正确,再确认是否已停用或注销,避免持续发起无效请求。
- 记录版本变化后旧结果还能用吗?
- 旧版本不再作为解析结果返回。应重新解析并使用当前版本,避免把过期地址带入业务。
- 批量解析中单条失败会影响整批吗?
- 不会。批量解析按行读取标识,单条失败不影响其他标识,失败项单独列出,可按错误类型修正后重提。
- 接入后地址变更要走什么流程?
- 按登记事项提交变更,记录版本随之递增。变更前先缩短 TTL,避免缓存未过期导致新旧地址并存。
办理须知
接入前请确认标识用途、调用方范围和目标地址已经确定,避免接入后频繁变更登记内容。涉及地址切换时,先缩短 TTL,等待旧缓存过期,再修改目标地址。
日常运维中保留每次解析的记录编号。出现结果不一致、返回码无法判断或批量异常时,记录编号可以帮助快速定位到具体请求。
- 调用凭据按主体和用途签发,设置有效期,不写入前端代码、公开仓库和日志。
- 解析记录保存标识、调用方、时间、返回码和记录编号,不保存业务正文。
- 解析规则变化以接入协议和变更日志为准。
- 材料不齐时会被退回补充,补齐后重新核验。
开始接入寻址
提交主体信息、标识用途和目标地址,按接入流程完成首次解析。