本文介绍由接口盒子提供的免费域名WHOIS查询API服务，帮助开发者快速获取域名的注册信息、到期时间、DNS服务器等关键数据。

---

一、接口基本信息

• ​功能说明​：查询顶级域名的WHOIS信息（不支持国别域名/中文域名）
• ​请求地址​：https://cn.apihz.cn/api/wangzhan/whois.php
• ​请求方式​：GET 或 POST
• ​认证方式​：用户ID + 通讯秘钥（需注册获取）
• ​频次限制​：公共KEY共享频次限制，建议使用个人KEY

---

二、请求参数说明

参数名	必填	说明
id	是	用户中心数字ID（如：id=10000000）
key	是	用户中心通讯秘钥（如：key=15he5h15ty854j5...）
domain	是	查询域名（不带协议，如：domain=example.com）

---

三、返回参数说明

返回JSON格式数据，主要字段包括：

• code：状态码（200成功/400错误）
• msg：提示信息
• addtime/endtime：注册/到期时间（UTC格式）
• ns1-ns7：NS服务器列表
• dnssec：DNSSEC签名状态
• status：域名锁状态（如禁止转移、更新等）

完整字段详见官方文档：API文档

---

四、调用示例

PHP 示例 (GET请求)

php

复制

<?php
$apiUrl = "https://cn.apihz.cn/api/wangzhan/whois.php";
$params = ['id' => 'YOUR_USER_ID',     // 替换为实际ID'key' => 'YOUR_API_KEY',   // 替换为实际KEY'domain' => 'example.com'  // 替换为目标域名
];$url = $apiUrl . '?' . http_build_query($params);
$response = file_get_contents($url);
$data = json_decode($response, true);if ($data['code'] == 200) {echo "域名到期时间: " . $data['endtime'];
} else {echo "查询失败: " . $data['msg'];
}
?>

Python 示例 (POST请求)

python

运行

复制

import requestsapi_url = "https://cn.apihz.cn/api/wangzhan/whois.php"
payload = {'id': 'YOUR_USER_ID',     # 替换为实际ID'key': 'YOUR_API_KEY',    # 替换为实际KEY'domain': 'example.com'   # 替换为目标域名
}response = requests.post(api_url, data=payload)
data = response.json()if data['code'] == 200:print(f"注册商: {data['zcname']}")print(f"到期时间: {data['endtime']}")print(f"NS服务器: {[ns for ns in data.values() if 'ns' in ns and data[ns]]}")
else:print("错误信息:", data['msg'])

---

五、注意事项

1. ​密钥安全​：示例中的88888888为公共测试KEY，请替换为您在接口盒子免费API用户中心获取的个人KEY
2. ​域名限制​：仅支持.com、.net等顶级域名，不支持.cn等国别域名
3. ​返回说明​：
   • ns3-ns7可能返回null，表示无额外NS服务器
   • 时间字段均为UTC标准时区（如：2025-09-28T10:57:46Z）
4. ​错误代码​：
   • 400：秘钥错误/不支持的域名后缀
   • 200：成功（完整数据见返回示例）