域名注册状态查询免费API接口详细教程

<?php
// 配置您的认证信息和要查询的域名
$api_url = "https://cn.apihz.cn/api/wangzhan/domainzc.php";
$your_id = "你的用户ID"; // 请替换为你的实际ID
$your_key = "你的用户KEY"; // 请替换为你的实际KEY
$your_domain = "example.com"; // 请替换为你要查询的域名
// 构建请求URL (GET方式)
$request_url = $api_url . "?id=" . urlencode($your_id) . "&key=" . urlencode($your_key) . "&domain=" . urlencode($your_domain);
// 初始化cURL会话
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $request_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 将响应结果返回，而不是直接输出
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 简便起见，忽略SSL证书验证（生产环境建议设为true）
curl_setopt($ch, CURLOPT_TIMEOUT, 30); // 设置超时时间
// 执行请求并获取响应
$response = curl_exec($ch);
// 检查是否有cURL错误
if (curl_errno($ch)) {
    die('cURL请求发生错误: ' . curl_error($ch));
}
// 关闭cURL资源
curl_close($ch);
// 解析JSON响应
$data = json_decode($response, true);
// 处理返回数据
if ($data['code'] == 200) {
    echo "查询域名: " . $data['domain'] . "\n";
    echo "注册状态: " . ($data['type'] == 1 ? "已注册" : "未注册") . "\n";
    
    if ($data['type'] == 1) {
        echo "WHOIS信息: \n" . $data['whois'] . "\n";
    }
} else {
    echo "查询失败，错误信息: " . $data['msg'] . "\n";
}
?>

import requests
import json
# 配置您的认证信息和要查询的域名
api_url = "https://cn.apihz.cn/api/wangzhan/domainzc.php"
your_id = "你的用户ID"  # 请替换为你的实际ID
your_key = "你的用户KEY"  # 请替换为你的实际KEY
your_domain = "example.com"  # 请替换为你要查询的域名
# 构建请求参数
params = {
    "id": your_id,
    "key": your_key,
    "domain": your_domain
}
try:
    # 发送GET请求
    response = requests.get(api_url, params=params, timeout=30)
    # 确保请求成功（状态码为200）
    response.raise_for_status()
    
    # 解析返回的JSON数据
    data = response.json()
    
    # 处理返回数据
    if data['code'] == 200:
        print(f"查询域名: {data['domain']}")
        status = "已注册" if data['type'] == 1 else "未注册"
        print(f"注册状态: {status}")
        
        if data['type'] == 1:
            print(f"WHOIS信息: \n{data['whois']}")
    else:
        print(f"查询失败，错误信息: {data['msg']}")
except requests.exceptions.RequestException as e:
    print(f"请求过程中发生错误: {e}")
except json.JSONDecodeError as e:
    print(f"解析JSON响应时发生错误: {e}")

{
    "code": 200,
    "domain": "this-domain-probably-not-registered-123456.cn",
    "type": 0
}

{
    "code": 200,
    "domain": "apihz.cn",
    "type": 1,
    "whois": "Domain Name: apihz.cn\nROID: 20240319s10001s56425741-cn\nDomain Status: clientUpdateProhibited\n...（完整的WHOIS信息）..."
}

{
    "code": 400,
    "msg": "通讯秘钥错误。"
}