API 使用说明
综合查询接口：WHOIS / IP / DNS（含 Domain Lookback 规划）
综合查询
域名/IPv4/IPv6 统一输入，返回注册信息与网络数据
输入目标
DOMAIN / IPv4 / IPv6
核心链路
RDAP 优先 + WHOIS 补充
数据输出
WHOIS + IP + DNS
查询能力
- WHOIS / RDAP：域名注册信息、注册商、到期时间、状态码
- IP 查询：IPv4 / IPv6 归属网络、ASN、地理位置
- DNS 摘要：A / AAAA / CNAME / MX / NS / TXT
- Lookback：历史快照能力（规划中）
返回结构
- 基础信息：目标类型、查询耗时、缓存状态
- 注册信息：Registrar、注册时间、到期时间、联系人
- 网络信息：Nameserver、IP、ASN、网络段
- 扩展信息：地理坐标、地图跳转、刷新缓存
示例目标
域名bluewhois.com
IPv41.1.1.1
IPv62606:4700:4700::1111
能力状态
WHOIS / RDAP已上线
IP 查询已上线
DNS 摘要已上线
Lookback规划中
使用说明
接口规范、数据来源与执行策略说明
数据来源
- whoAPIWhois API
- WhoisXML APIWHOIS Lookup
- RDAP 服务器列表从 https://data.iana.org/rdap/dns.json 下载，30 天缓存
- Public Suffix List从 https://publicsuffix.org/list/public_suffix_list.dat 下载，30 天缓存
- IP 信息来源MaxMind GeoIP Databases
接口路径
统一 API 路径：其中 {target} 可以是域名、IPv4、IPv6。
https://bluewhois.com/api/{target}
示例（域名）：https://bluewhois.com/api/bluewhois.com
示例（IPv4）：https://bluewhois.com/api/1.1.1.1
示例（IPv6）：https://bluewhois.com/api/2606:4700:4700::1111
注意：实际请求时建议对 IPv6 做 URL 编码（例如 %3A）。
执行策略
- 域名查询优先 RDAP，并结合付费 WHOIS 数据源（WhoAPI / WhoisXML）补充完整字段。
- IP 查询使用 RDAP IP，结合 MaxMind GeoIP 数据补充网络与地理信息。
错误处理
当主要服务不可用时，系统会自动切换备用数据源并返回标准错误结构，确保接口可用性与可诊断性。
技术支持
如果您在使用过程中遇到任何问题，请通过以下方式联系我们：
邮箱：support@bluewhois.com
问题反馈：GitHub Issues