Whois域名查询API集成指南：从零搭建域名信息查询工具

1. 引言

在互联网生态中，域名是企业的数字门牌。无论是安全研究、品牌监控还是SEO分析，快速获取域名的注册信息、到期时间、DNS记录等数据都至关重要。Whois查询正是实现这一目标的核心手段。然而，传统命令行或在线查询工具效率低下、难以批量处理。将Whois查询能力封装成API并集成到自己的应用中，已成为开发者的标准解决方案。本文将以ApiZero平台上的Whois域名查询API为例，手把手教你从零开始集成，并提供多语言生产级代码。

2. Whois API 概述

2.1 什么是Whois查询

Whois是一种基于TCP的查询协议，用于向域名注册局查询域名当前的拥有者、注册日期、过期日期、域名服务器等公开信息。最初由RFC 812定义，后在RFC 3912中更新。每次注册或转移域名时，注册人需要提交真实信息，这些信息（部分可公开）被存储在WHOIS数据库中。

一条典型的Whois记录包含：

• 域名名称：example.com
• 注册人组织：Example Inc.
• 注册邮箱：admin@example.com（通常隐匿处理）
• 创建日期：2020-01-01
• 过期日期：2025-01-01
• 域名服务器：ns1.example.com
• 状态：clientTransferProhibited 等

2.2 传统Whois查询的痛点

通过命令行执行whois example.com虽然直接，但存在以下问题：

• 输出格式不统一，不同TLD的返回结构差异大
• 缺乏标准化JSON解析，不适合程序化处理
• 存在速率限制，频繁查询易被屏蔽
• 无法直接集成到Web或移动端应用

因此，RESTful形式的Whois API应运而生。

3. 为什么选择聚合API平台

3.1 ApiZero平台简介

ApiZero（极数本源）是一个聚合API工具集市，覆盖天气、IP、翻译、AI、Whois等数百个高质量API。它提供统一的管理面板、在线调试工具、清晰的文档和稳定的SLA。利用聚合平台，开发者无需分别对接多家数据源，只需一个API Key即可调用多个接口，极大降低了集成复杂度。

3.2 统一管理与快速接入

• 一站式注册：无需与各数据供应商单独签约
• 在线调试：在API市场内直接测试接口，查看返回JSON
• 多语言SDK：提供官方Python、JavaScript等SDK（或手写HTTP）
• 计费透明：按调用量付费，有免费额度可供试用

4. 集成步骤详解

4.1 注册账号与获取密钥

1. 访问 ApiZero 官网（apizero.cn），点击“免费注册”
2. 完成邮箱或手机验证
3. 登录后进入“控制台” -> “API Key”，生成一个私有密钥（如sk-xxxxxxxxxxxx）
4. 将密钥妥善保管，后续所有API请求需在Header或参数中携带

4.2 理解API接口文档

假设Whois查询API的端点为：

GET https://api.apizero.cn/apis/whois?domain={domain}&apikey={apikey}

请求参数：

返回示例（JSON）：

{ "code": 0, "message": "success", "data": { "domain": "example.com", "registrar": "Example Registrar Inc.", "creation_date": "2020-01-01T00:00:00Z", "expiration_date": "2025-01-01T00:00:00Z", "nameservers": ["ns1.example.com", "ns2.example.com"], "status": ["clientTransferProhibited"], "registrant_name": "Domain Administrator", "registrant_organization": "Example Inc.", "registrant_country": "US", "admin_email": "admin@example.com", "dnssec": false } }

错误码：

4.3 发起第一次API请求

你可以使用任何HTTP客户端，例如curl：

curl "https://api.apizero.cn/apis/whois?domain=example.com&apikey=sk-xxxxxxxxxxxx"

如果返回{"code":0, ...}，则集成成功。

5. 代码实战：多语言调用示例

5.1 Python 示例（使用requests库）

import requests API_KEY = "sk-xxxxxxxxxxxx" # 替换为你的密钥 BASE_URL = "https://api.apizero.cn/apis/whois" def query_whois(domain: str) -> dict: """ 查询域名WHOIS信息 :param domain: 域名，如 "example.com" :return: 解析后的字典，包含data字段或错误信息 """ params = { "domain": domain, "apikey": API_KEY } try: resp = requests.get(BASE_URL, params=params, timeout=10) resp.raise_for_status() # 检查HTTP状态码 data = resp.json() if data["code"] == 0: return data["data"] else: raise Exception(f"API错误: {data['message']} (code={data['code']})") except requests.exceptions.RequestException as e: raise Exception(f"网络请求失败: {e}") # 使用示例 if __name__ == "__main__": try: info = query_whois("example.com") print(f"域名: {info['domain']}") print(f"注册商: {info['registrar']}") print(f"过期时间: {info['expiration_date']}") print(f"DNS服务器: {', '.join(info['nameservers'])}") except Exception as e: print(f"查询失败: {e}")

5.2 JavaScript（Fetch API）示例

适用于Node.js或浏览器环境（需处理CORS）。这里以Node.js 18+为例：

const API_KEY = 'sk-xxxxxxxxxxxx'; const BASE_URL = 'https://api.apizero.cn/apis/whois'; async function queryWhois(domain) { const url = new URL(BASE_URL); url.searchParams.append('domain', domain); url.searchParams.append('apikey', API_KEY); const response = await fetch(url.toString(), { method: 'GET', headers: { 'Accept': 'application/json' } }); if (!response.ok) { throw new Error(`HTTP ${response.status}`); } const data = await response.json(); if (data.code === 0) { return data.data; } else { throw new Error(`API错误: ${data.message} (code=${data.code})`); } } // 使用 (async () => { try { const info = await queryWhois('example.com'); console.log(info); } catch (err) { console.error(err.message); } })();

5.3 Java（OkHttp）示例

import okhttp3.*; import org.json.JSONObject; import java.io.IOException; public class WhoisClient { private static final String API_KEY = "sk-xxxxxxxxxxxx"; private static final String BASE_URL = "https://api.apizero.cn/apis/whois"; private final OkHttpClient client = new OkHttpClient(); public JSONObject queryWhois(String domain) throws IOException { HttpUrl url = HttpUrl.parse(BASE_URL).newBuilder() .addQueryParameter("domain", domain) .addQueryParameter("apikey", API_KEY) .build(); Request request = new Request.Builder() .url(url) .get() .addHeader("Accept", "application/json") .build(); try (Response response = client.newCall(request).execute()) { if (!response.isSuccessful()) { throw new IOException("Unexpected code " + response); } String body = response.body().string(); JSONObject json = new JSONObject(body); if (json.getInt("code") == 0) { return json.getJSONObject("data"); } else { throw new IOException("API错误: " + json.getString("message")); } } } public static void main(String[] args) throws Exception { WhoisClient client = new WhoisClient(); JSONObject info = client.queryWhois("example.com"); System.out.println("域名: " + info.getString("domain")); System.out.println("过期时间: " + info.getString("expiration_date")); } }

6. 进阶：错误处理与性能优化

6.1 常见错误码及处理策略

6.2 缓存策略

同一域名的Whois信息通常不会频繁变化（注册信息可能几年不变），因此缓存可以大幅减少API调用量。建议采用如下缓存方案：

• 内存缓存：使用字典或LRU缓存，TTL设为1小时
• 分布式缓存：使用Redis，key为whois:{domain}，TTL设为6小时
• 注意：域名过期前一个月可用剩余天数动态调整缓存时间

Python简易缓存示例：

import time from functools import lru_cache @lru_cache(maxsize=128) def get_whois_cached(domain: str, ttl_seconds=3600): # 实际调用API并返回结果 return query_whois(domain)

（注：lru_cache不自动过期，生产环境建议使用cachetools库的TTLCache）

7. 应用场景

1. 域名监控：定期扫描自己的域名列表，邮件提醒即将过期或被盗的域名。
2. 安全研究：分析恶意域名注册信息，追踪注册模式。
3. 品牌保护：监控相似域名注册，及时发现仿冒域名。
4. SEO工具：检查目标域名的注册历史，辅助评估网站信用。
5. 域名交易：批量查询过期域名，寻找潜在购买机会。

8. 总结

本文从Whois的基础概念出发，分析了传统查询的弊端，并详细演示了如何通过聚合API平台（以ApiZero为例）快速集成Whois域名查询功能。通过Python、JavaScript、Java三份生产级代码示例，你可以直接复制使用。此外，本文还讨论了错误处理与缓存优化，确保集成健壮高效。

集成Whois API只是第一步，聚合平台提供了更多如IP地理、天气、翻译等接口，推荐开发者探索组合使用，打造更强大的工具链。

（本文涉及的所有代码和API接口仅为演示，实际使用时请替换为真实的API Key并查阅最新文档。）