「DNS解析查询」是数据鱼API平台提供的单点域名解析查询接口,Base 路径 /api/dns-lookup,共 2 个端点。它接收一个域名和一个记录类型,返回该域名当前的解析记录集合,每条记录包含主机名、记录类型、记录值与 TTL,用于确认某条解析是否生效、指向哪里、缓存多久。
这个接口的定位是「单点、单次、即时」:一次只查一个域名的一种记录类型,返回一个扁平的结果集,不涉及多节点对比、历史轨迹或批量域名。它回答的是「此刻这条记录是什么」,而不是「这条记录在全球是否一致」。需要判断解析生效范围时,应使用面向多节点的传播检测能力,两者不能互相替代。
记录结构按类型收敛为统一形态:A 记录给出 ip 字段,NS 等别名类记录给出 target 字段,所有记录都带 ttl。调用方无需为不同记录类型写多套解析逻辑,按字段是否存在取值即可。响应沿用平台统一的三段结构,便于与其它接口共用同一套错误处理与重试策略。
方法 | 路径 | 说明 | 鉴权 |
|---|---|---|---|
GET | /api/dns-lookup/ping | 健康检查,返回服务版本 | 免鉴权 |
GET | /api/dns-lookup/query | 查询单个域名的解析记录集 | 需要 |
鉴权使用 X-API-Key 请求头或 ?api_key= 查询参数,缺失返回 4011、无效返回 4013。响应结构为 {code, msg, data},code 为 0 表示成功。缺少 domain 时返回 4001,参数格式非法返回 4002,取值不在支持列表返回 4003,目标未收录返回 4004;4040 为路由不存在,4050 为方法不允许,5000/5001 为服务内部错误。解析依赖不可用时返回 5031/5032,接口不会以缓存值或占位值冒充查询结果。GET 与 POST 均可调用,POST 支持 JSON body 与表单,参数名与查询参数一致;这是数据鱼API平台开发工具类接口的统一约定。
用途:查询指定域名在指定记录类型下的解析结果。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
domain | string | 是 | — | 待查询的域名,API.md 标注为可选,实际缺失返回 4001 |
type | string | 否 | A | 记录类型,服务端统一转为大写后回显 |
返回字段要点:domain 为请求中的域名原样回显;type 为规范化后的记录类型;records 为记录数组,元素含 host(记录所属主机名)、type(单条记录类型)、ttl(缓存生存时间,单位秒),并按类型附加 ip(A 记录的地址)或 target(NS 等记录的目标)。records 可能同时包含不同类型,调用方应以每条记录的 type 为准,而不是只看请求的 type。
GET /api/dns-lookup/query?api_key=YOUR_KEY&domain=YOUR_DOMAIN&type=A免鉴权,无参数,返回当前服务版本,用于探活与网关健康检查。
GET /api/dns-lookup/ping原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。