WHOIS查询API文档
快速准确获取域名注册信息、注册商、到期日期、DNS服务器等详细信息
1. API概述
本API提供WHOIS查询服务，支持全球域名查询，可获取域名的注册商、注册日期、到期日期、DNS服务器等详细信息。
2. 接口地址
GET
https://whois.yzxlq.fun/api.php
3. 请求参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| domain | string | 必填 | 要查询的域名，例如：example.com |
4. 响应格式
code number
响应状态码：200成功，其他为错误
message string
响应消息，描述请求结果
data object/array
响应数据，查询成功时返回WHOIS信息，失败时为null
5. 响应示例
成功响应
{
"code": 200,
"message": "查询成功",
"data": {
"domain": "example.com",
"registrar": "MarkMonitor Inc.",
"creation_date": "1995-08-14 04:00:00",
"expiration_date": "2027-08-13 04:00:00",
"updated_date": "2023-08-14 07:02:33",
"status": "clientDeleteProhibited, clientTransferProhibited, clientUpdateProhibited, serverDeleteProhibited, serverTransferProhibited, serverUpdateProhibited",
"name_servers": [
"a.iana-servers.net",
"b.iana-servers.net"
],
"registrant_name": "Internet Assigned Numbers Authority",
"registrant_email": "abuse-contact@markmonitor.com",
"registrant_organization": "Internet Assigned Numbers Authority",
"is_available": false,
"available": false,
"domain_suffix": "com",
"api_used": "whoiscx"
}
}
失败响应
{
"code": 400,
"message": "域名格式不正确，请输入有效的域名，如：example.com",
"data": null
}
6. 错误码说明
| 错误码 | 描述 |
|---|---|
| 400 | 参数错误，如缺少domain参数或域名格式不正确 |
| 429 | 请求过于频繁，请稍后再试（每秒最多1次请求） |
| 500 | 服务器内部错误，如WHOIS服务不可用 |
7. 使用示例
cURL示例
curl "https://whois.yzxlq.fun/api.php?domain=example.com"
JavaScript示例
fetch('https://whois.yzxlq.fun/api.php?domain=example.com')
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
Python示例
import requests
response = requests.get('https://whois.yzxlq.fun/api.php?domain=example.com')
data = response.json()
print(data)
8. 限流说明
为保证服务稳定性，本API实施IP限流策略：
- 每个IP每秒最多允许1次请求
- 超过限制的请求将返回429错误
- 限流基于滑动窗口算法实现
9. 数据来源
本API使用以下WHOIS数据源：
- whoiscx API
- whois.vu API
API会自动切换数据源，确保查询成功率。
10. 注意事项
- 请确保域名格式正确，不包含http://或https://前缀
- 部分域名可能因隐私保护无法获取完整信息
- 建议添加适当的错误处理逻辑
- 请勿用于非法用途
11. 联系我们
如有问题或建议，请通过以下方式联系我们：
QQ：3876873183