本文介紹由接口盒子提供的免費域名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：成功（完整數據見返回示例）