本文介绍由接口盒子提供的免费域名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 requests api_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'])
五、注意事项
- 密钥安全：示例中的
88888888为公共测试KEY，请替换为您在接口盒子用户中心获取的个人KEY - 域名限制：仅支持
.com、.net等顶级域名，不支持.cn等国别域名 - 返回说明：
ns3-ns7可能返回null，表示无额外NS服务器- 时间字段均为UTC标准时区（如：
2025-09-28T10:57:46Z）
- 错误代码：
400：秘钥错误/不支持的域名后缀200：成功（完整数据见返回示例）
