接口调用地址
线路类型一 [普通集群负载-IP接口]
说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。
线路类型二 [普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三 [VIP集群负载-VIP线路接口]
说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 域名 | domain | 是 | 要查询的域名，区分主域和子域，例如查询主域则传apihz.cn，具体的子域则传cn.apihz.cn，可以是二级域名，三级域名等。例：domain=apihz.cn |
| 页码 | page | 否 | 默认第1页。例：page=1 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | 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 | 总页数。 |
返回数据示例
示例：{"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
}
}
更新记录
