「DNS传播检测」是数据鱼API平台用于观察解析记录可见性的查询接口,Base 路径 /api/dns-propagation,共 2 个端点。它按域名与记录类型执行一次解析查询,返回当前解析链路实际取到的记录集合与条数,并支持 A、AAAA、MX、TXT、CNAME、NS、SOA 七种类型以及 ANY 通配查询。与只返回精简字段的解析查询不同,这里保留记录的原生字段,便于核对各类记录的内容差异。
传播检测关注的不是「记录是否存在」,而是「变更后各处看到的是新值还是旧值」。接口提供的是检测流程中的采样点:每次调用给出该解析视角下的一份快照,调用方按时间或按网络位置重复采样,比较记录值、TTL 与条数是否收敛。因此在接入方式上,它更适合被巡检任务、发布流水线和监控系统周期调用,而不是在页面里被用户逐次手动触发。
记录字段依类型而变:地址类记录给出地址与 TTL,邮件类记录给出优先级与目标,文本类记录给出字符串数组,授权类记录给出主域名、序列号与刷新重试等时间参数。接口不对字段做二次加工,保留原始解析结果,这让它可以直接用于配置比对与审计留痕。
方法 | 路径 | 说明 | 鉴权 |
|---|---|---|---|
GET | /api/dns-propagation/ping | 健康检查,同时返回支持的记录类型清单 | 免鉴权 |
GET | /api/dns-propagation/lookup | 对指定域名与记录类型执行一次解析快照查询 | 需要 |
鉴权使用 X-API-Key 请求头或 ?api_key= 查询参数,缺失返回 4011、无效返回 4013。响应为 {code, msg, data} 三段结构,code 为 0 表示成功。参数错误中,4001 为缺少必填参数、4002 为参数格式或取值非法、4003 为取值不在支持列表、4004 为目标未收录;4040 为路由不存在,4050 为方法不允许,5000/5001 为服务内部错误,5031/5032 为上游依赖不可用。此接口在解析失败时返回 5001 而不是空记录集,这一点与「查无此记录」的语义不同,调用方应当区分。以上为数据鱼API平台开发工具类接口的通用约定。
用途:取指定域名与类型的一次解析结果,作为传播对比的样本。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
domain | string | 是 | — | 待检测的域名,API.md 标注为可选,实际缺失返回 4001 |
type | string | 否 | A | 记录类型,支持 A、AAAA、MX、TXT、CNAME、NS、SOA 与 ANY,统一转大写 |
返回字段要点:domain 与 type 为请求回显;count 为本次取到的记录条数;records 为记录数组,字段随类型不同,常见包括 host、ttl,地址类记录另含 ip(IPv4)或 ipv6,MX 含 pri 与 target,TXT 含 txt 文本数组,CNAME 与 NS 含 target,SOA 含 mname、rname、serial、refresh、retry、expire、minimum。ANY 会一次带回多种类型的记录,适合做变更前后的整体比对。
GET /api/dns-propagation/lookup?api_key=YOUR_KEY&domain=YOUR_DOMAIN&type=A免鉴权,无参数。除探活外,它的响应还列出 supported_types,可作为客户端启动时的能力发现:A、AAAA、MX、TXT、CNAME、NS、SOA。需要注意该清单未列出 lookup 实际接受的 ANY,判断可用类型时以两个端点的并集为准。
GET /api/dns-propagation/ping原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。