引言Whois 是互联网基础设施中极为重要的协议用于查询域名是否已被注册、注册人信息、注册商、到期日期等关键数据。对于开发者而言手动通过命令行whois example.com查询虽简单却难以集成到自动化流程中。随着 API 经济的兴起Whois 域名查询 API成为了构建域名监控、品牌保护、安全研究等应用的首选方案。以 ApiZero 极数本源 这样的聚合 API 市场为例它们将数百个高质量 API包括 Whois 统一接入开发者只需5分钟即可完成认证、获取密钥并调用。本文将从接口原理到代码实战带你完整掌握 Whois API 的使用。一、Whois 域名查询 API 简介Whois API 是对传统 Whois 协议的 RESTful 封装返回结构化 JSON 数据通常包含以下核心信息字段说明示例domainName查询的域名example.comregistrar注册商名称NameCheap, Inc.registrant注册人可能被隐私保护隐藏Whois Privacy ServicecreationDate注册时间1997-09-15T04:00:00ZexpirationDate到期时间2028-09-14T04:00:00ZnameServers权威 DNS 服务器列表[ns1.example.com, ns2.example.com]status域名状态如 clientTransferProhibited[clientTransferProhibited]API 一般通过 GET 请求调用传入域名参数返回 JSON。聚合平台还会提供统一的鉴权、计费和限流机制。二、API 调用准备2.1 获取 API Key大多数商业 API 需要注册并获取密钥。以 ApiZero 为例假设其 Whois API 位于/marketplace/whois流程如下注册账号并登录进入 Whois API 详情页素材中提到的页面订阅或获取免费额度得到 API Key如sk-xxxx阅读文档了解请求端点和参数约束2.2 接口与参数假设通用端点为GET https://api.apizero.cn/v1/whois?domain{domain}apikey{apikey}常用参数参数必填说明domain是要查询的域名如 example.comapikey是认证密钥通常放在 Header 而非 URL 中更安全verbose否是否返回完整原始 Whois 文本true/false默认 falseformat否响应格式通常固定为 json最佳实践将 API Key 配置为环境变量避免硬编码。三、接口调用示例3.1 使用 curl 快速测试# 假设 API Key 已设置为环境变量 curl -s https://api.apizero.cn/v1/whois?domainexample.comapikey$API_KEY | jq .返回的 JSON 示例{ domainName: EXAMPLE.COM, registrar: RESERVED-Internet Assigned Numbers Authority, creationDate: 1995-08-14T04:00:00Z, expirationDate: 2026-08-13T04:00:00Z, nameServers: [ A.IANA-SERVERS.NET, B.IANA-SERVERS.NET ], status: [clientDeleteProhibited, clientTransferProhibited, clientUpdateProhibited], registrant: Internet Assigned Numbers Authority, rawWhois: null }3.2 Python 实战代码以下是一个完整的 Python 脚本用于查询域名 Whois 信息并打印关键字段import os import requests from typing import Dict, Any API_KEY os.getenv(WHOIS_API_KEY, your_api_key_here) API_URL https://api.apizero.cn/v1/whois def query_whois(domain: str) - Dict[str, Any]: 查询域名的 Whois 信息 :param domain: 域名如 example.com :return: 解析后的 JSON 字典 headers { Authorization: fBearer {API_KEY}, Accept: application/json } params { domain: domain, verbose: false } try: response requests.get(API_URL, headersheaders, paramsparams, timeout10) response.raise_for_status() # 如果状态码不是200抛出异常 data response.json() return data except requests.exceptions.RequestException as e: print(f请求失败: {e}) return {} def main(): domain input(请输入要查询的域名 (例如 example.com): ).strip() if not domain: domain example.com result query_whois(domain) if result: print(f域名: {result.get(domainName, N/A)}) print(f注册商: {result.get(registrar, N/A)}) print(f创建日期: {result.get(creationDate, N/A)}) print(f到期日期: {result.get(expirationDate, N/A)}) print(fDNS 服务器: {, .join(result.get(nameServers, []))}) else: print(未查询到有效信息请检查域名和 API Key。) if __name__ __main__: main()运行说明安装依赖pip install requests设置环境变量WHOIS_API_KEY或在代码中直接替换执行脚本输入域名即可3.3 JavaScript (Fetch) 调用const API_KEY process.env.WHOIS_API_KEY || your_api_key_here; const url https://api.apizero.cn/v1/whois?domainexample.com; fetch(url, { headers: { Authorization: Bearer ${API_KEY}, Accept: application/json } }) .then(response { if (!response.ok) throw new Error(HTTP error! status: ${response.status}); return response.json(); }) .then(data { console.log(Whois 数据:, data); }) .catch(error { console.error(请求失败:, error); });四、响应数据结构解析返回的 JSON 对象常见字段及处理方式字段名类型说明使用场景domainNamestring查询的域名大写用于展示registrarstring当前注册商域名迁移时参考creationDatestring (ISO 8601)注册时间计算域名年龄expirationDatestring到期时间监控续费预警nameServersarray名称服务器列表DNS 变更检查statusarray域名状态码列表检测域名是否被锁定registrantstring注册人名称可能被隐藏联系域名所有者rawWhoisstring原始 Whois 文本verbosetrue时深度解析注意creationDate和expirationDate通常以 UTC 格式返回需要转换为本地时间。例如在 Python 中可以from datetime import datetime exp_date_str result.get(expirationDate) if exp_date_str: exp_dt datetime.fromisoformat(exp_date_str.replace(Z, 00:00)) print(f到期时间本地: {exp_dt.astimezone()})五、实际应用场景5.1 域名到期监控通过定时任务如 crontab调用 Whois API检查多个域名的到期日期到期前 30 天自动发送邮件或钉钉通知。示例# 在上一节的 main 函数基础上增加到期判断 import datetime exp_date result.get(expirationDate) if exp_date: exp datetime.datetime.fromisoformat(exp_date.replace(Z, 00:00)) days_left (exp - datetime.datetime.utcnow()).days if days_left 30: print(f⚠️ 域名 {domain} 将在 {days_left} 天后到期请及时续费)5.2 域名注册信息变更检测定期调用并将结果与上次缓存对比若注册商、DNS 服务器发生变化触发告警。这可用于发现域名劫持或配置错误。5.3 批量域名估值与交易分析结合 Whois 中的创建时间、过期时间等评估域名价值。许多后端系统会调用 Whois API 作为数据源。六、聚合 API 市场的优势以 ApiZero 为例参考素材中介绍的 ApiZero 极数本源它聚合了天气、IP、翻译、AI、Whois 等数百个 API并提供以下便利统一认证一个 API Key 可调用所有 API无需逐一注册在线调试在网页上即可测试接口预览响应素材中提及“在线调试与调用示例”稳定计费按调用量付费免费额度充足标准化文档每个 API 都有相似的结构降低学习成本5分钟接入从注册到首次调用通常不超过5分钟素材所述对于开发者而言与其逐一对接不同服务商的 Whois API不如通过一个聚合市场快速集成后续维护也更简单。七、常见问题与最佳实践7.1 请求频率限制大部分免费或低价 Whois API 会限制每分钟请求数如 60次/分钟。建议在代码中添加指数退避重试机制使用缓存对同域名一天内只查一次购买更高流量包7.2 数据隐私问题由于 GDPR 等法规很多域名的注册人信息被隐藏显示为 Redacted 或代理。API 返回的registrant字段可能非真实所有者需要留意。7.3 错误码处理常见 HTTP 状态码状态码含义处理方式200成功解析 JSON400参数错误检查 domain 格式401未授权检查 API Key403无权限套餐不足或未订阅429频率超限等待后重试500服务端错误重试或联系客服7.4 代码中 API Key 管理永远不要将 API Key 硬编码在代码公开仓库中使用环境变量或密钥管理服务如 AWS Secrets Manager前端调用时通过后端代理避免暴露 Key结语Whois 域名查询 API 是网络基础设施的实用组件无论你是运维人员、安全工程师还是全栈开发者都能从中受益。结合聚合 API 市场如 ApiZero的便捷性你可以在几分钟内搭建起自动化域名信息查询与监控系统。本文提供的 Python、JavaScript 示例均已可运行你可以直接复制到项目中使用。最后牢记 API 调用的最佳实践保护密钥、处理错误、合理缓存。让 Whois 数据为你的应用赋能提升自动化与智能水平。