首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >域名WHOIS信息查询免费API使用指南

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

原创
作者头像
用户9840656
发布2025-07-18 18:20:58
发布2025-07-18 18:20:58
4800
举报

本文介绍由接口盒子提供的免费域名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请求)
代码语言:javascript
复制
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请求)
代码语言:javascript
复制
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,请替换为您在接口盒子用户中心获取的个人KEY
  2. 域名限制​:仅支持.com.net等顶级域名,不支持.cn等国别域名
  3. 返回说明​:
    • ns3-ns7可能返回null,表示无额外NS服务器
    • 时间字段均为UTC标准时区(如:2025-09-28T10:57:46Z
  4. 错误代码​:
    • 400:秘钥错误/不支持的域名后缀
    • 200:成功(完整数据见返回示例)

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、接口基本信息
  • 二、请求参数说明
  • 三、返回参数说明
  • 四、调用示例
    • PHP 示例 (GET请求)
    • Python 示例 (POST请求)
  • 五、注意事项
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档