域名WHOIS信息查询免费API使用指南

本文介绍由接口盒子提供的免费域名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'])

---

五、注意事项

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