文章内容
接口简介:

查询指定域名权威NS服务器的解析记录值,CNAME解析链等。例如查询主域a.com做了哪些A,MX,TXT记录等,也可查询子域名如b.a.com的解析记录。可用于判断权威记录是否与边缘记录一致,判断记录是否准确,判断是否有敏感解析等各类应用场景。



请求地址:

https://cn.apihz.cn/api/wangzhan/dnsq.php



请求方式:

POST或GET。



请求参数:

【名称】【参数】【必填】【说明】

【用户ID】【id】【是】【用户中心的数字ID,例:id=10000000】

【用户KEY】【key】【是】【用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2】

【域名】【domain】【是】【要查询的域名,区分主域和子域,例如查询主域则传apihz.cn,具体的子域则传cn.apihz.cn,可以是二级域名,三级域名等。例:domain=apihz.cn】

【页码】【page】【否】【默认第1页。例:page=1】



返回参数:

【名称】【参数】【说明】

【状态码】【code】【200成功,400错误。】

【信息提示】【msg】【提示信息。】

【查询域名】【domain】【查询域名。】

【权威NS服务器】【authoritative_server】【请求的NS解析服务器。】

【CNAME解析链】【cname_chain】【CNAME跟随的完整链条,从根域名到最终目标。】

【查询耗时】【elapsed】【本次查询总耗时(秒)。】

【查询时间】【queried_at】【本次查询的服务器时间。】

【DNS服务商】【provider】【识别到的DNS服务商(auto/aliyun/tencentcloud等)。】

【查询结果集】【data】【查询结果集。】

【A记录结果集】【data.A】【A记录(IPv4地址)结果集。】

【记录头】【data.A.name】【记录头(主机名)。】

【生存时间】【data.A.ttl】【A记录的TTL(秒)。】

【记录类型】【data.A.type】【固定为 A。】

【记录值】【data.A.data】【解析到的IPv4地址。】

【AAAA记录结果集】【data.AAAA】【AAAA记录(IPv6地址)结果集。】

【记录头】【data.AAAA.name】【记录头(主机名)。】

【生存时间】【data.AAAA.ttl】【AAAA记录的TTL(秒)。】

【记录类型】【data.AAAA.type】【固定为 AAAA。】

【记录值】【data.AAAA.data】【解析到的IPv6地址。】

【CNAME记录结果集】【data.CNAME】【CNAME(别名)记录结果集。】

【记录头】【data.CNAME.name】【记录头(主机名)。】

【生存时间】【data.CNAME.ttl】【CNAME记录的TTL(秒)。】

【记录类型】【data.CNAME.type】【固定为 CNAME。】

【记录值】【data.CNAME.data】【别名指向的目标域名。】

【MX记录结果集】【data.MX】【MX(邮件交换)记录结果集。】

【记录头】【data.MX.name】【记录头(主机名)。】

【生存时间】【data.MX.ttl】【MX记录的TTL(秒)。】

【记录类型】【data.MX.type】【固定为 MX。】

【优先级】【data.MX.priority】【邮件服务器优先级,值越小越优先。】

【记录值】【data.MX.data】【邮件服务器主机名。】

【TXT记录结果集】【data.TXT】【TXT记录结果集。】

【记录头】【data.TXT.name】【记录头(主机名)。】

【生存时间】【data.TXT.ttl】【TXT记录的TTL(秒)。】

【记录类型】【data.TXT.type】【固定为 TXT。】

【记录值】【data.TXT.data】【TXT文本内容。】

【NS记录结果集】【data.NS】【NS(域名服务器)记录结果集。】

【记录头】【data.NS.name】【记录头(主机名)。】

【生存时间】【data.NS.ttl】【NS记录的TTL(秒)。】

【记录类型】【data.NS.type】【固定为 NS。】

【记录值】【data.NS.data】【权威NS服务器主机名。】

【SOA记录结果集】【data.SOA】【SOA(起始授权机构)记录结果集。】

【记录头】【data.SOA.name】【记录头(主机名)。】

【生存时间】【data.SOA.ttl】【SOA记录的TTL(秒)。】

【记录类型】【data.SOA.type】【固定为 SOA。】

【主DNS服务器】【data.SOA.mname】【主权威DNS服务器。】

【管理员邮箱】【data.SOA.rname】【区域负责人邮箱(. 代 @)。】

【序列号】【data.SOA.serial】【区域版本序列号。】

【刷新时间】【data.SOA.refresh】【从服务器刷新间隔(秒)。】

【重试时间】【data.SOA.retry】【重试间隔(秒)。】

【过期时间】【data.SOA.expire】【过期时间(秒)。】

【最小TTL】【data.SOA.minimum】【否定缓存最小TTL(秒)。】

【CAA记录结果集】【data.CAA】【CAA(证书颁发授权)记录结果集。】

【记录头】【data.CAA.name】【记录头(主机名)。】

【生存时间】【data.CAA.ttl】【CAA记录的TTL(秒)。】

【记录类型】【data.CAA.type】【固定为 CAA。】

【标志位】【data.CAA.flags】【CAA标志位(0/128)。】

【标签】【data.CAA.tag】【CAA标签(issue/issuewild/iodef)。】

【记录值】【data.CAA.data】【CAA值(如证书颁发者)。】

【SRV记录结果集】【data.SRV】【SRV(服务定位)记录结果集。】

【记录头】【data.SRV.name】【记录头(主机名)。】

【生存时间】【data.SRV.ttl】【SRV记录的TTL(秒)。】

【记录类型】【data.SRV.type】【固定为 SRV。】

【优先级】【data.SRV.priority】【优先级,值越小越优先。】

【权重】【data.SRV.weight】【权重,用于负载均衡。】

【端口】【data.SRV.port】【服务端口号。】

【记录值】【data.SRV.data】【目标主机名。】

【SPF记录结果集】【data.SPF】【SPF(发件人策略框架)记录结果集。】

【记录头】【data.SPF.name】【记录头(主机名)。】

【生存时间】【data.SPF.ttl】【SPF记录的TTL(秒)。】

【记录类型】【data.SPF.type】【固定为 SPF。】

【记录值】【data.SPF.data】【SPF策略文本(如 v=spf1 a mx ~all)。】

【当前页码】【pagination.page】【当前页码。】

【每页条数】【pagination.page_size】【每页记录数。】

【总记录数】【pagination.total】【符合查询条件的总记录数。】

【总页数】【pagination.total_pages】【总页数。】



GET请求示例:

https://cn.apihz.cn/api/wangzhan/dnsq.php?id=88888888&key=88888888&domain=apihz.cn&page=1

注意:示例里的ID与KEY为公共ID与KEY,共享每分钟调用频次限制,接口本身免费,请使用自己的ID与KEY,独享每分钟调用频次。每日调用无上限。



POST请求示例:

请根据开发语言自行POST。



返回数据示例:

示例:{"code":400,"msg":"通讯秘钥错误。"}

示例:

{

"code": 200,

"msg": "success",

"domain": "apihz.cn",

"authoritative_server": "ns4.dnsv2.com (124.64.205.155)",

"cname_chain": [

"apihz.cn",

"apihz.cn.a1.initzz.com"

],

"elapsed": 0.225,

"queried_at": "2026-08-27 23:37:59",

"provider": "tencentcloud",

"data": {

"A": [

{

"name": "apihz.cn.a1.initzz.com",

"ttl": 180,

"type": "A",

"data": "101.227.20.146"

},

{

"name": "apihz.cn.a1.initzz.com",

"ttl": 180,

"type": "A",

"data": "101.227.20.143"

},

{

"name": "apihz.cn.a1.initzz.com",

"ttl": 180,

"type": "A",

"data": "101.227.20.101"

},

{

"name": "apihz.cn.a1.initzz.com",

"ttl": 180,

"type": "A",

"data": "101.227.20.141"

}

],

"CNAME": [

{

"name": "apihz.cn",

"ttl": 60,

"type": "CNAME",

"data": "apihz.cn.a1.initzz.com"

}

],

"TXT": [

{

"name": "apihz.cn",

"ttl": 60,

"type": "TXT",

"data": "v=spf1 a mx ~all"

}

],

"NS": [

{

"name": "apihz.cn",

"ttl": 36619,

"type": "NS",

"data": "ns4.dnsv2.com"

},

{

"name": "apihz.cn",

"ttl": 36619,

"type": "NS",

"data": "ns3.dnsv2.com"

}

],

"SPF": [

{

"name": "apihz.cn",

"ttl": 60,

"type": "SPF",

"data": "v=spf1 a mx ~all"

}

],

"AAAA": [],

"MX": [],

"SOA": [],

"CAA": [],

"SRV": []

},

"pagination": {

"page": 1,

"page_size": 100,

"total": 9,

"total_pages": 1

}

}

示例:

{

"code": 200,

"msg": "success",

"domain": "cn.apihz.cn",

"authoritative_server": "unknown",

"cname_chain": [

"cn.apihz.cn"

],

"elapsed": 0.103,

"queried_at": "2026-08-27 23:38:29",

"provider": "tencentcloud",

"data": {

"A": [

{

"name": "cn.apihz.cn",

"ttl": 25,

"type": "A",

"data": "124.220.236.177"

},

{

"name": "cn.apihz.cn",

"ttl": 25,

"type": "A",

"data": "124.222.2.141"

},

{

"name": "cn.apihz.cn",

"ttl": 25,

"type": "A",

"data": "124.222.204.22"

},

{

"name": "cn.apihz.cn",

"ttl": 25,

"type": "A",

"data": "129.211.70.28"

},

{

"name": "cn.apihz.cn",

"ttl": 25,

"type": "A",

"data": "43.142.65.209"

},

{

"name": "cn.apihz.cn",

"ttl": 25,

"type": "A",

"data": "49.235.116.180"

},

{

"name": "cn.apihz.cn",

"ttl": 25,

"type": "A",

"data": "81.68.85.14"

},

{

"name": "cn.apihz.cn",

"ttl": 25,

"type": "A",

"data": "101.34.207.105"

},

{

"name": "cn.apihz.cn",

"ttl": 25,

"type": "A",

"data": "101.35.2.25"

},

{

"name": "cn.apihz.cn",

"ttl": 25,

"type": "A",

"data": "121.4.64.15"

}

],

"AAAA": [],

"CNAME": [],

"MX": [],

"TXT": [],

"NS": [],

"SOA": [],

"CAA": [],

"SRV": [],

"SPF": []

},

"pagination": {

"page": 1,

"page_size": 100,

"total": 10,

"total_pages": 1

}

}



参考资料(版权):

https://www.apihz.cn/api/wangzhandnsq.html
如有侵权请联系我们删除!