DNS 查询 API：记录数组、TTL 与空结果含义-优快云博客

GuGuData DNS 查询 API 使用 GET 接收不含协议、路径或端口的域名，按 A、AAAA、MX、TXT、NS、CNAME、SRV、PTR、SOA 等记录类型返回数组。没有记录的类型会省略；合法全空结果为 {}，并沿用不扣调用包的判定。

原始 API 封面

接口与输入

项目	说明
请求方法	GET
接口地址	`https://api.gugudata.com/v2/websitetools/dns-lookup`
返回格式	JSON，UTF-8
鉴权	对应产品有效 AppKey；下方示例使用 Header

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	无	支持 appkey/appKey Query、X-GUGUDATA-APPKEY/X-API-Key Header 或 Bearer；多处提供时须一致。
domain	string	是	YOUR_VALUE	域名，不含协议、路径或端口；支持国际化域名，参数不可重复。只查询该名称及其解析链，不遍历子域或发现全部服务名称。

参数名和大小写按契约传递。鉴权凭据可以通过 Header 提供，不需要在公开 URL 中放入真实 AppKey。

请求示例

以下为集成示例，未使用真实凭据执行。YOUR_APPKEY 是占位符，正式调用需要对应产品权益。GET 参数由 --data-urlencode 分别编码。

curl --get 'https://api.gugudata.com/v2/websitetools/dns-lookup' \
  --header 'X-GUGUDATA-APPKEY: YOUR_APPKEY' \
  --data-urlencode 'domain=gugudata.com'

返回字段

参数名	参数类型	备注
dataStatus.requestParameter	string	安全的域名参数，不包含凭据。
dataStatus.statusCode	integer	HTTP状态码
dataStatus.status	string	请求状态
dataStatus.statusDescription	string	请求状态的描述
dataStatus.responseDateTime	string	响应时间
dataStatus.dataTotalCount	integer	沿用对象计数口径，成功为 1，并非记录条数。
data.*	array	按类型分组的记录数组；无记录类型省略，全空返回空对象并沿用不扣调用包的判定。
data.*.domain	string	解析的域名
data.*.ttl	string	DNS 记录提供的 TTL 字符串；记录可能来自有效期内的 DNS 缓存。
data.*.class	string	解析记录的类别
data.*.type	string	解析记录的类型
data.*.value	string	解析记录的值

公开 Demo 样本

2026 年 11 月 6 日回读了对应公开 Demo。公开 Demo 查询的是 baidu.com，与上方正式请求示例的 gugudata.com 不同。下方仅摘取实际返回的第一条 A 记录，其余记录已省略，地址与 TTL 都是采样时的值。

{
  "dataStatus": {
    "statusCode": 200
  },
  "data": {
    "A": [
      {
        "domain": "baidu.com.",
        "ttl": "254",
        "class": "IN",
        "type": "A",
        "value": "111.63.65.103"
      }
    ]
  }
}

公开 Demo 是样本结构证据，不代表上方带占位符的生产请求已经执行，不用于推断固定性能、完整覆盖范围或长期有效性。

字段解释与使用边界

接口只查询输入名称及既有解析链，不遍历所有子域，不保证发现全部 SRV 服务，也不按域名自动执行 IP 反查。每种记录类型下面是对象数组，不能把 data.A 当作字符串。ttl、class、type、value 均按字符串读取；TTL 来自 DNS 记录，结果可能来自仍在有效期内的缓存，不能当作全网传播完成证明。dataTotalCount 成功时为 1，表示结果对象而非 DNS 记录条数。解析失败返回 503，应与合法空对象区分。DNS 有记录也不代表 HTTP 服务可以访问。