WHOIS查询

文档导航

WHOIS查询API文档

完整的API接口说明，助力快速集成域名查询功能

快速测试

输入域名（如 example.com）立即测试API查询效果

概述

本API提供域名WHOIS信息查询服务，支持获取域名注册信息、注册商信息、DNS服务器、域名状态等核心数据， 同时提供用户反馈提交接口（正在开发ing…），适用于域名信息核验、批量查询、域名监控等场景。

2
核心接口
JSON
响应格式
CORS
跨域支持

适用场景

  • 域名信息批量核验系统
  • 域名到期监控工具
  • 网站管理平台集成
  • 域名投资分析工具
  • 网络安全检测系统

基础信息

接口域名

https://apiwhois.wyyzxzyg.cn
http://127.0.0.1:5000

生产环境建议使用HTTPS协议，本地开发可使用HTTP协议

请求方式

接口名称 请求方式 内容格式
WHOIS查询接口 GET URL参数
反馈提交接口（正在开发ing…） POST FormData

响应格式

统一返回JSON格式，包含状态码、数据/错误信息

{
  "status": 1, // 1=成功，0=失败
  "data": { // 成功时返回的数据
    ...
  },
  "error": null // 失败时返回的错误信息
}

状态码说明

状态码 描述 说明
1 操作成功 请求正常处理并返回数据
0 操作失败 请求处理失败，error字段包含具体原因

WHOIS域名查询接口

接口地址

/whois

请求参数

参数名 类型 是否必填 描述 示例
domain string 是 需查询的域名（不含http:///https://） wyyzxzyg.cn

请求示例

GET https://apiwhois.wyyzxzyg.cn/whois?domain=wyyzxzyg.cn

cURL示例

curl -X GET "https://apiwhois.wyyzxzyg.cn/whois?domain=wyyzxzyg.cn"

JavaScript示例

fetch('https://apiwhois.wyyzxzyg.cn/whois?domain=wyyzxzyg.cn')
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));

成功响应示例

{
  "data": {
    "domain": "wyyzxzyg.cn",
    "domain_suffix": "cn",
    "info": {
      "creation_days": 278,
      "creation_time": "2025-02-02 19:24:55",
      "domain": "wyyzxzyg.cn",
      "domain_status": [
        "注册商禁止转移（clienttransferprohibited）"
      ],
      "expiration_time": "2026-02-02 19:24:55",
      "is_expire": 0,
      "name_server": [
        "sergi.ns.cloudflare.com",
        "adaline.ns.cloudflare.com"
      ],
      "registrant_email": "2738226109@qq.com",
      "registrant_name": "***",
      "registrar_name": "商中在线科技股份有限公司",
      "valid_days": 86,
      "whois_server": "whois.cnnic.cn"
    },
    "is_available": 0,
    "query_time": "2025-11-08 12:38:12",
    "raw": "{\n \"domain_name\": \"wyyzxzyg.cn\",\n \"registrar\": \"商中在线科技股份有限公司\",\n \"creation_date\": \"2025-02-02 11:24:55+00:00\",\n \"expiration_date\": \"2026-02-02 11:24:55+00:00\",\n \"name_servers\": [\n \"sergi.ns.cloudflare.com\",\n \"adaline.ns.cloudflare.com\"\n ],\n \"status\": \"clientTransferProhibited\",\n \"emails\": \"2738226109@qq.com\",\n \"dnssec\": \"unsigned\",\n \"name\": \"***\"\n}"
  },
  "status": 1
}

失败响应示例

{
  "data": {
    "domain": "invalid-domain",
    "query_time": "2025-11-08 15:32:10",
    "raw": ""
  },
  "error": "未查询到域名信息，请确认域名是否正确",
  "status": 0
}

响应字段说明

字段路径 类型 描述
data domain string 查询的域名
data domain_suffix string 域名后缀（如 com、cn、top）
data.info.creation_time string 注册时间（UTC+8 格式）
data.info.expiration_time string 到期时间（UTC+8 格式）
data.info.creation_days number 域名已注册天数
data.info.valid_days number 剩余有效天数（负数表示已过期）
data.info.registrant_name string 注册人姓名/机构
data.info.registrant_email string 注册人邮箱
data.info.registrar_name string 注册商名称
data.info.whois_server string WHOIS服务器地址
data.info.name_server array DNS服务器列表
data.info domain_status array 域名状态（中文描述+英文标识）
data.info.is_expire number 是否过期（0=未过期，1=已过期）
data.is_available number 域名是否可注册（0=已注册，1=可注册）
data.query_time string 查询时间（UTC+8 格式）
data.raw string 完整WHOIS原始数据
status number 接口响应状态（1=成功，0=失败）

用户反馈提交接口（正在开发ing…）

接口地址

/submit-feedback

请求参数（FormData格式）

参数名 类型 是否必填 描述 示例
name string 是 提交人姓名 张三
email string 是 联系邮箱（用于回复） zhangsan@example.com
content string 是 反馈内容/问题描述 请问如何批量查询WHOIS信息？

请求示例

POST https://apiwhois.wyyzxzyg.cn/submit-feedback
Content-Type: multipart/form-data

name=张三&email=zhangsan@example.com&content=请问如何批量查询WHOIS信息？

cURL示例

curl -X POST "https://apiwhois.wyyzxzyg.cn/submit-feedback" \ -F "name=张三" \ -F "email=zhangsan@example.com" \ -F "content=请问如何批量查询WHOIS信息？"

JavaScript示例

const formData = new FormData();
formData.append('name', '张三');
formData.append('email', 'zhangsan@example.com');
formData.append('content', '请问如何批量查询WHOIS信息？');

fetch('https://apiwhois.wyyzxzyg.cn/submit-feedback', {
  method: 'POST',
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));

成功响应示例

{
  "status": 1,
  "message": "反馈提交成功！我们会尽快与您联系"
}

失败响应示例

{
  "status": 0,
  "message": "请填写问题描述"
}

调用限制

用户类型 单日查询上限 每秒查询限制 备注
普通用户 100 次 2 次/秒 基于IP地址限制
认证用户 1000 次 5 次/秒 基于API密钥限制（需申请）
商业用户 自定义 10 次/秒 联系客服定制配额

超出限制处理

  • 目前暂不支持申请密钥增加限制，请耐心等待
  • 超出每秒查询限制：返回 429 状态码，建议降低查询频率
  • 超出单日查询限制：当日无法继续查询，次日 00:00 重置配额
  • 恶意刷接口：IP/API密钥可能被临时封禁（24-72小时）

API请求限制说明

禁止行为

  • 高频次无意义查询（如短时间内重复查询同一域名）
  • 利用API进行商业爬虫、数据抓取并用于商业用途
  • 伪造请求来源、IP地址或用户身份
  • 通过代理服务器、VPN等方式规避调用限制
  • 将API返回数据用于非法用途（如垃圾邮件、诈骗等）

合理使用建议

  • 批量查询时，建议在请求间添加 500ms-1s 间隔，避免触发频率限制
  • 对同一域名的查询间隔不小于 10 分钟，减少服务器压力
  • 缓存查询结果，避免重复请求相同域名信息
  • 商业用途请联系客服申请商业授权，获取更高配额
  • 及时处理API返回的错误码，避免无效重试

其他限制说明

  • 单次请求仅支持查询一个域名，不支持批量域名参数
  • 域名长度限制：最长不超过 63 个字符（含后缀）
  • 支持的域名后缀：仅支持常见通用顶级域名（.com、.cn、.top、.xin等）和部分国家顶级域名
  • 请求超时时间：默认 10 秒，超时将返回 504 状态码
  • API服务可能会根据服务器负载动态调整临时限制

违规处理

对于违反请求限制的行为，我们将采取以下处理措施：

  1. 第一次违规：警告通知，临时限制查询配额 24 小时
  2. 第二次违规：限制查询配额 72 小时，取消认证用户资格（如有）
  3. 第三次违规：永久封禁IP/API密钥，禁止使用API服务
  4. 情节严重者：保留追究法律责任的权利

错误码说明

状态码 错误描述 可能原因 解决方案
400 参数错误 未传入domain参数或参数格式无效 检查域名格式，确保传入有效域名（如 example.com）
404 接口不存在 请求的接口地址错误 检查接口地址是否为 /whois 或 /submit-feedback
429 请求过于频繁/查询次数超限 超出每秒查询限制（2次/秒）或每日查询配额（100次/24H） 请求频繁请稍后重试；每日超限需24小时后再试
500 服务器内部错误 服务器处理请求时发生异常 稍后重试，或联系技术支持反馈问题
504 请求超时 WHOIS服务器响应缓慢或网络异常 稍后重试，或检查网络连接
0（业务错误） 未查询到域名信息 域名不存在、已删除或WHOIS信息未公开 检查域名拼写是否正确，或尝试其他域名

常见问题

Q：API返回的域名状态有哪些常见类型？

A：常见域名状态包括：注册商禁止转移（clienttransferprohibited）、注册商禁止删除（clientdeleteprohibited）、注册商禁止更新（clientupdateprohibited）、服务器禁止转移（servertransferprohibited）、服务器禁止删除（serverdeleteprohibited）、正常状态（ok）等，所有状态均采用"中文描述（英文标识）"的格式返回。

Q：如何申请更高的API调用配额？（暂未开通密钥、认证模式，可商业）

A：普通用户默认配额为100次/天，如需更高配额，可通过以下方式申请：1）联系客服提交认证申请（个人/企业身份证明）；2）说明使用场景和需求配额；3）认证通过后将升级为认证用户（1000次/天）；4）商业用户需签订合作协议，获取自定义配额。

Q：API返回的数据更新频率是多少？

A：API数据实时从域名注册商的WHOIS服务器获取，无缓存。但注册商的WHOIS信息更新存在延迟（通常24-48小时），因此修改域名信息后，可能需要1-2天才能通过API查询到最新数据。

Q：是否支持HTTPS协议？

A：支持。生产环境建议使用 HTTPS 协议（https://apiwhois.wyyzxzyg.cn），确保数据传输安全；本地开发环境可使用 HTTP 协议（http://127.0.0.1:5000）。

Q：跨域请求需要注意什么？

A：API已开启CORS跨域支持，前端可直接调用，无需额外配置。如果出现跨域错误，请检查请求方式和接口地址是否正确，或联系技术支持排查问题。

Q：如何获取技术支持？

A：遇到API使用问题，可通过以下方式获取支持：1）查看本API文档和使用帮助；2）通过反馈提交接口提交问题；3）发送邮件至 2738226109@qq.com；4）通过QQ：2738226109私聊联系我。