[DEMO] 域名 DNS 信息查询

查询域名的 DNS 记录，按记录类型返回结果。无记录类型省略；合法全空返回空对象，沿用不扣调用包的判定。查询预算最多 20 秒，解析失败返回 503。只查询输入名称及既有解析链，不遍历所有子域，不保证发现全部 SRV 服务，也不按域名自动执行 IP 反查。TTL 为 DNS 记录提供的值；记录可能来自仍在有效期内的 DNS 缓存。示例输入保持 baidu.com，结果和 TTL 随实际解析变化。

当前接口契约

接口详情：https://www.gugudata.com/api/details/dnslookup

公开 Demo 用于查看调用方式和响应结构，返回范围以示例参数为准。

正常响应

HTTP 200，application/json。

字段	类型	说明
dataStatus	object
dataStatus.requestParameter	string / null	安全的域名参数，不包含凭据。
dataStatus.statusCode	integer
dataStatus.status	string
dataStatus.statusDescription	string
dataStatus.responseDateTime	string
dataStatus.dataTotalCount	integer	沿用对象计数口径，成功为 1，并非记录条数。
data	object

业务状态说明

业务状态码	业务状态码解释	备注
200	成功	SUCCESS; HTTP 200
503	解析或鉴权服务暂时不可用	UPSTREAM_UNAVAILABLE / AUTH_SERVICE_UNAVAILABLE; HTTP 503

返回响应

🟢200成功

application/json

返回按类型分组的记录对象，合法全空为 {}。

Bodyapplication/json

示例

{
  "dataStatus": {
    "requestParameter": "",
    "statusCode": 200,
    "status": "SUCCESS",
    "statusDescription": "successfully / 成功",
    "responseDateTime": "2026-10-02 18:59:23",
    "dataTotalCount": 1
  },
  "data": {
    "A": [
      {
        "domain": "baidu.com.",
        "ttl": "523",
        "class": "IN",
        "type": "A",
        "value": "124.237.177.164"
      },
      {
        "domain": "baidu.com.",
        "ttl": "523",
        "class": "IN",
        "type": "A",
        "value": "110.242.74.102"
      },
      {
        "domain": "baidu.com.",
        "ttl": "523",
        "class": "IN",
        "type": "A",
        "value": "111.63.65.103"
      },
      {
        "domain": "baidu.com.",
        "ttl": "523",
        "class": "IN",
        "type": "A",
        "value": "111.63.65.247"
      }
    ],
    "MX": [
      {
        "domain": "baidu.com.",
        "ttl": "349",
        "class": "IN",
        "type": "MX",
        "value": "20 mx.baidu.com."
      },
      {
        "domain": "baidu.com.",
        "ttl": "349",
        "class": "IN",
        "type": "MX",
        "value": "10 mx.maillb.baidu.com."
      }
    ],
    "TXT": [
      {
        "domain": "baidu.com.",
        "ttl": "682",
        "class": "IN",
        "type": "TXT",
        "value": "9279nznttl321bxp1j464rd9vpps246v"
      },
      {
        "domain": "baidu.com.",
        "ttl": "682",
        "class": "IN",
        "type": "TXT",
        "value": "google-site-verification=GHb98-6msqyx_qqjGl5eRatD3QTHyVB6-xQ3gJB5UwM"
      },
      {
        "domain": "baidu.com.",
        "ttl": "682",
        "class": "IN",
        "type": "TXT",
        "value": "_globalsign-domain-verification=qjb28W2jJSrWj04NHpB0CvgK9tle5JkOq-EcyWBgnE"
      },
      {
        "domain": "baidu.com.",
        "ttl": "682",
        "class": "IN",
        "type": "TXT",
        "value": "v=spf1 include:spf1.baidu.com include:spf2.baidu.com include:spf3.baidu.com include:spf4.baidu.com -all"
      }
    ],
    "NS": [
      {
        "domain": "baidu.com.",
        "ttl": "2695",
        "class": "IN",
        "type": "NS",
        "value": "ns7.baidu.com."
      },
      {
        "domain": "baidu.com.",
        "ttl": "2695",
        "class": "IN",
        "type": "NS",
        "value": "ns2.baidu.com."
      },
      {
        "domain": "baidu.com.",
        "ttl": "2695",
        "class": "IN",
        "type": "NS",
        "value": "ns3.baidu.com."
      },
      {
        "domain": "baidu.com.",
        "ttl": "2695",
        "class": "IN",
        "type": "NS",
        "value": "dns.baidu.com."
      },
      {
        "domain": "baidu.com.",
        "ttl": "2695",
        "class": "IN",
        "type": "NS",
        "value": "ns4.baidu.com."
      }
    ],
    "SOA": [
      {
        "domain": "baidu.com.",
        "ttl": "1327",
        "class": "IN",
        "type": "SOA",
        "value": "dns.baidu.com. sa.baidu.com. 2012151506 300 300 2592000 600"
      }
    ]
  }
}

🔴503业务错误，结合六字段 dataStatus 判断。

当前接口契约

正常响应

业务状态说明

请求参数

请求示例代码

返回响应

[DEMO] 域名 DNS 信息查询

当前接口契约#

正常响应#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

正常响应

业务状态说明