在做域名监测、网站资产盘点、SEO 分析或是抢注提醒时，快速拿到一个域名的

是最高频的需求之一。接口盒子提供了一个免费的域名 WHOIS 查询接口 ，底层采用 

实时向注册机构请求数据，支持大部分域名后缀，返回标准 JSON，方便各种语言直接接入。

本文将基于从接口原理、参数说明、返回格式到 PHP / Python 调用示例，给你一份能直接复制使用的完整指南。

直接在浏览器或 HTTP 客户端请求：

https://接口盒子/api/wangzhan/domainzc2.php?id=88888888&key=88888888&domain=erguanmingmin.com

下面给出 GET 方式的完整 PHP 示例，实际项目中推荐用 POST 隐藏凭证。

<?php

$apiUrl = 'https://接口盒子/api/wangzhan/domainzc2.php';

// 1. 替换为你在接口盒子用户中心获取的 ID 和 KEY
$params = [
    'id'     => 'YOUR_USER_ID',      // TODO: 替换为实际 ID
    'key'    => 'YOUR_API_KEY',      // TODO: 替换为实际 KEY
    'domain' => '***.com'  // 查询的域名，不要带 http
];

// 2. 拼接 GET 请求 URL
$url = $apiUrl . '?' . http_build_query($params);

// 3. 发起请求（生产环境建议用 curl，这里用 file_get_contents 演示）
$response = file_get_contents($url);
if ($response === false) {
    die("请求失败，请检查网络或接口地址");
}

// 4. 解析 JSON
$data = json_decode($response, true);
if ($data === null) {
    die("JSON 解析失败: " . $response);
}

// 5. 根据 code 处理结果
switch ($data['code']) {
    case 200:
        echo "✅ 查询成功\n";
        echo "域名: {$data['domain']}\n";
        echo "注册时间: {$data['create']}\n";
        echo "到期时间: {$data['expire']}\n";

        // 顺手算一下剩余天数
        $expireTime = strtotime($data['expire']);
        $daysLeft   = ceil(($expireTime - time()) / 86400);
        echo "剩余天数: {$daysLeft} 天\n";
        break;

    case 404:
        echo "❌ 该域名未注册\n";
        break;

    case 400:
        echo "❌ 请求错误: {$data['msg']}\n";
        break;

    default:
        echo "未知状态码: {$data['code']}，消息: {$data['msg']}\n";
}

 库，GET 和 POST 各给一个版本。

import requests
import json
from datetime import datetime

def query_domain_expire(user_id: str, api_key: str, domain: str) -> dict:
    """
    查询域名的注册时间和到期时间

    :param user_id: 接口盒子用户 ID
    :param api_key: 接口盒子通讯秘钥
    :param domain: 查询的域名（不含 http）
    :return: 解析后的结果字典
    """
    url = "https://接口盒子/api/wangzhan/domainzc2.php"
    params = {
        "id": user_id,
        "key": api_key,
        "domain": domain
    }

    try:
        resp = requests.get(url, params=params, timeout=10)
        resp.raise_for_status()
    except requests.RequestException as e:
        return {"success": False, "error": f"请求异常: {e}"}

    data = resp.json()

    if data.get("code") == 200:
        create = data.get("create")
        expire = data.get("expire")

        # 计算剩余天数
        try:
            expire_dt = datetime.strptime(expire, "%Y-%m-%d %H:%M:%S")
            days_left = (expire_dt - datetime.now()).days
        except Exception:
            days_left = None

        return {
            "success": True,
            "domain": data.get("domain"),
            "create": create,
            "expire": expire,
            "days_left": days_left
        }
    elif data.get("code") == 404:
        return {"success": False, "error": "该域名未注册"}
    else:
        return {"success": False, "error": data.get("msg", "未知错误")}


if __name__ == "__main__":
    # TODO: 替换为你的 ID 和 KEY
    USER_ID = "YOUR_USER_ID"
    API_KEY = "YOUR_API_KEY"

    result = query_domain_expire(USER_ID, API_KEY, "erguanmingmin.com")
    if result.get("success"):
        print(f"✅ 查询成功")
        print(f"域名: {result['domain']}")
        print(f"注册时间: {result['create']}")
        print(f"到期时间: {result['expire']}")
        print(f"剩余天数: {result['days_left']} 天")
    else:
        print(f"❌ 查询失败: {result['error']}")

POST 方式（推荐，凭证不出现在 URL 中） 

import requests

def query_domain_post(user_id: str, api_key: str, domain: str) -> dict:
    url = "https://接口盒子/api/wangzhan/domainzc2.php"
    payload = {
        "id": user_id,
        "key": api_key,
        "domain": domain
    }

    resp = requests.post(url, data=payload, timeout=10)
    return resp.json()


# 调用
if __name__ == "__main__":
    result = query_domain_post("YOUR_USER_ID", "YOUR_API_KEY", "erguanmingmin.com")
    print(result)

在做域名监测、网站资产盘点、SEO 分析或是抢注提醒时，快速拿到一个域名的注册时间和到期时间是最高频的需求之一。接口盒子提供了一个免费的域名 WHOIS 查询接口 ，底层采用 WHOIS + RDAP 双模式实时向注册机构请求数据，支持大部分域名后缀，返回标准 JSON，方便各种语言直接接入。

域名注册时间与到期时间查询免费 API 接口完整教程

编程语言

免费域名WHOIS查询接口，支持WHOIS+RDAP双通道查询，返回JSON格式的域名注册/到期时间。提供PHP/Python调用示例，适用于SEO分析、域名监测等场景，每日调用无上限。

Python

JSON

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

域名注册时间与到期时间查询免费 API 接口完整教程

域名注册时间与到期时间查询免费 API 接口完整教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐