DNS 解析记录查询

接口标识: dnsquery 价格: 0.005 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

DNS 解析记录查询接口传入域名即可查询 A、AAAA、CNAME、MX、TXT、NS、SOA 七类记录，逗号分隔可一次查多个类型，也可指定公共 DNS 服务器（如 223.5.5.5）对比解析结果，缺省用系统解析。每条记录返回类型、记录值与 TTL，MX 附优先级。域名不存在或该类型无记录时不报错，返回空记录列表与提示信息。适合域名解析诊断、DNS 配置核查、邮件服务器 MX 记录查询等场景。

详细介绍

![DNS 解析记录查询接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_dnsquery__1794363282_75b6c224b8de.png)

域名解析生效了吗？邮件 MX 记录配对了吗？传入域名即可拿到全部解析记录明细，配置问题一查便知。

## 接口概述
面向建站、邮件系统部署、CDN 切换等需要确认域名解析状态的场景，接口按域名查询 A、AAAA、CNAME、MX、TXT、NS、SOA 七类解析记录，支持一次查询多个类型，也可指定公共 DNS 服务器对比不同出口的解析结果。每条记录以结构化字段返回类型、记录值与 TTL，可直接嵌入域名管理面板与解析诊断工具，帮助运维人员快速定位解析未生效、记录配置错误与缓存差异问题。

## 核心能力
1. **七类记录全覆盖**：A、AAAA、CNAME、MX、TXT、NS、SOA 均支持，逗号分隔可一次查多个类型。
2. **指定服务器解析**：可指定公共 DNS 服务器（如 223.5.5.5、8.8.8.8），对比不同解析出口的结果差异。
3. **结构化返回**：每条记录含类型、值与 TTL，MX 附优先级，SOA 返回主服务器、序列号等完整对象。
4. **容错友好**：域名不存在或类型无匹配不报错，返回空记录列表并附说明提示。

## 产品优势
1. **接入简单**：一次 POST 同步返回，无需自建解析客户端。
2. **类型齐全**：常见诊断所需的七类记录一个入口全部覆盖。
3. **容错友好**：查无记录不算失败，业务侧无需处理异常分支。
4. **准确规范**：TTL、MX 优先级等字段结构化返回，可直接用于自动化判断。
5. **降本增效**：嵌入域名管理与建站流程，解析问题当场验证，减少人工排查。

## 效果展示
一句话理解：它就像在电话簿里查一家店的登记信息——报上名字，它的注册地址、收件点、别名一次全列出来。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| domain | example.com | 待查询域名，不带协议与路径，最长 253 字符 |
| type | A,MX | 记录类型，支持七类，逗号分隔可多个，默认 A |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 查询域名 | `"example.com"` | `domain` |
| 实际查询类型 | `["A","MX"]` | `types` |
| 使用的 DNS 服务器 | `"system"` | `dns_server`，system 表示系统默认解析 |
| 记录总数 | 2 | `record_count` |
| 记录明细 | A 与 MX 各一条 | `records`，每项含 `type`、`value`、`ttl`，MX 另有 `priority` |

API请求示例：

```
POST /api/dnsquery
domain=example.com&type=A,MX
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "domain": "example.com",
    "types": [
      "A",
      "MX"
    ],
    "dns_server": "system",
    "record_count": 2,
    "records": [
      {
        "type": "A",
        "value": "93.184.216.34",
        "ttl": 3279
      },
      {
        "type": "MX",
        "value": "mail.example.com",
        "ttl": 3600,
        "priority": 10
      }
    ]
  },
  "request_id": "b2d4f6a8c0e143579a1b3c5d7e9f0a2b"
}
```

types 回显本次实际查询的记录类型；若指定 dns_server，该字段返回服务器 IP 而非 system。查无记录时 records 为空数组并附 note 说明。

## 应用场景
- **解析诊断**：域名换配置后确认新记录已生效、旧记录已下线。
- **邮件部署**：核对 MX 记录与优先级，确认邮件路由指向正确。
- **多出口对比**：指定不同公共 DNS 服务器，比对各地解析结果差异。
- **资产盘点**：批量核对自有域名的 A/AAAA/NS 记录，梳理解析台账。

## 应用案例
**建站服务商**：每次为客户更换解析都要确认记录是否生效，此前靠工程师手动逐个查询。现在域名管理面板接入本接口，客户点一下即可看到 A、MX 等记录与 TTL，解析是否生效当场可证，客服沟通成本明显下降。

**企业邮箱管理员**：部署邮件系统前需要确认 MX 记录与优先级配置正确，通过本接口分别指定不同公共 DNS 服务器查询对比，确认各地解析一致后再切流量，避免了因解析缓存差异导致的收信故障。

常见问题

Q：域名不存在会报错吗？

A：不会。域名不存在或所查记录类型无匹配时，返回空 records 数组并附 note 提示，响应 code 仍为 0。

Q：可以指定 DNS 服务器吗？

A：可以。dns_server 传公共 DNS 服务器 IP（如 223.5.5.5），仅接受 IP 且必须为公网地址；不传则用系统默认解析。

Q：支持哪些记录类型？

A：A、AAAA、CNAME、MX、TXT、NS、SOA 七类，type 参数用逗号分隔可一次查询多个类型，结果合并在 records 数组返回。

DNS 域名解析网络诊断运维工具

接口地址： https://www.phpwc.cn/api/dnsquery

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`domain`	string	必填	-	待查询的域名，如 example.com（不带协议与路径）
`type`	string	选填	`A`	DNS 记录类型，支持 A / AAAA / CNAME / MX / TXT / NS / SOA，默认 A；多类型用逗号分隔如 A,AAAA,MX
`dns_server`	string	选填	-	指定 DNS 服务器 IP（如 223.5.5.5 / 8.8.8.8），默认使用系统解析；只接受 IP 地址，不接受域名

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`domain`	string	查询的域名
`types`	array	实际查询的记录类型数组
`dns_server`	string	使用的 DNS 服务器（system 表示系统默认）
`record_count`	int	返回的记录总数
`records`−	array	DNS 记录数组，每项含 type 记录类型、value 记录值、ttl 生存时间（秒）
`type`	string	记录类型（A / AAAA / CNAME / MX / TXT / NS / SOA）
`value`	string	记录值（A/AAAA 为 IP，MX 为交换服务器，TXT 为文本，SOA 为对象含 mname/rname/serial 等）
`ttl`	int	生存时间（秒）
`priority`	int	MX 记录优先级（仅 MX 类型有此字段）
`note`	string	当无记录时的提示信息
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试