查询域名Whois

# 域名Whois查询API ## 1. 接口说明 查询域名的Whois注册信息。系统采用**多级查询机制**，首先查询注册局Whois服务器，获取注册商Whois服务器地址后，自动查询注册商服务器以获取更详细的注册人信息。支持所有国际域名后缀，无需手动配置。 ## 2. 接口地址 **URL:** `https://api.xunjinlu.fun/api/whois/index.php` **请求方式:** GET / POST **响应格式:** application/json **编码格式:** UTF-8 ## 3. 请求参数说明 | 参数名 | 类型 | 必填 | 说明 | | :--- | :--- | :--- | :--- | | domain | String | 是 | 目标域名，支持所有国际域名后缀，支持URL格式自动提取 | ## 4. 返回参数说明 ### 4.1 基础信息 | 字段名 | 类型 | 说明 | | :--- | :--- | :--- | | data.domain | String | 查询的域名 | | data.tld | String | 顶级域名后缀 | | data.whois_server | String | 注册局Whois服务器地址 | | data.registrar_whois_server | String | 注册商Whois服务器地址（多级查询） | | data.status | String | 注册状态（"已注册" / "未注册"） | ### 4.2 注册商信息 | 字段名 | 类型 | 说明 | | :--- | :--- | :--- | | data.registrar | String | 注册商名称 | | data.registrar_url | String | 注册商官方网址 | | data.registrar_iana_id | String | 注册商IANA编号 | | data.registrar_abuse_email | String | 注册商滥用投诉邮箱 | | data.registrar_abuse_phone | String | 注册商滥用投诉电话 | ### 4.3 时间信息 | 字段名 | 类型 | 说明 | | :--- | :--- | :--- | | data.create_time | String | 域名注册时间 | | data.expire_time | String | 域名过期时间 | | data.update_time | String | 域名最后更新时间 | ### 4.4 域名状态 | 字段名 | 类型 | 说明 | | :--- | :--- | :--- | | data.domain_status | Array | 域名状态列表（如：clientTransferProhibited） | | data.dns_servers | Array | DNS服务器列表 | | data.dnssec | String | DNSSEC状态（signed / unsigned） | ### 4.5 注册人信息 | 字段名 | 类型 | 说明 | | :--- | :--- | :--- | | data.registrant | Object | 注册人信息对象 | | data.registrant.name | String | 注册人姓名 | | data.registrant.organization | String | 注册人组织/公司 | | data.registrant.street | String | 注册人街道地址 | | data.registrant.city | String | 注册人城市 | | data.registrant.state | String | 注册人省份/州 | | data.registrant.postal_code | String | 注册人邮编 | | data.registrant.country | String | 注册人国家代码 | | data.registrant.phone | String | 注册人电话 | | data.registrant.fax | String | 注册人传真 | | data.registrant.email | String | 注册人邮箱 | ### 4.6 其他联系人信息 | 字段名 | 类型 | 说明 | | :--- | :--- | :--- | | data.admin | Object | 管理员联系人信息 | | data.tech | Object | 技术联系人信息 | | data.billing | Object | 账单联系人信息 | ### 4.7 其他信息 | 字段名 | 类型 | 说明 | | :--- | :--- | :--- | | data.raw | String | 原始Whois文本数据 | | data.query_sources | Array | 查询来源（registry注册局 / registrar注册商） | | data.response_time | String | 查询耗时 | ## 5. 常见域名状态说明 | 状态码 | 说明 | | :--- | :--- | | ok | 正常状态 | | clientTransferProhibited | 客户端禁止转移（已开启转移锁） | | clientDeleteProhibited | 客户端禁止删除 | | clientUpdateProhibited | 客户端禁止更新 | | serverTransferProhibited | 服务器禁止转移 | | serverDeleteProhibited | 服务器禁止删除 | | serverUpdateProhibited | 服务器禁止更新 | | clientRenewProhibited | 客户端禁止续费 | | pendingDelete | 等待删除 | | redemptionPeriod | 赎回期 | | pendingTransfer | 等待转移 | ## 6. 错误码说明 | 错误码 | 说明 | | :--- | :--- | | 200 | 成功 | | 400 | 参数错误（缺少domain或域名格式不正确） | | 500 | 查询失败（不支持的域名后缀、Whois服务器无响应等） | ## 7. 关于隐私保护说明 根据 **ICANN 临时规范**，自2018年5月25日起，大多数 gTLD（通用顶级域名）的注册人信息会被默认隐藏（WHOIS隐私保护）。返回数据中注册人信息可能显示为： - `REDACTED FOR PRIVACY` - `Data Redacted` - `Not Disclosed` - 空对象 `{}` 这是符合国际规范的行为，并非API解析失败。如需获取完整信息，请联系对应注册商或使用官方RDDS服务。

> **由 AI 生成**：本文档由 AI 根据接口配置自动生成，仅供参考，实际接口行为以官方文档为准。 --- # 接口文档：查询域名 Whois ## 接口简介 本 API 用于查询域名的 Whois 注册信息，支持提取 URL 中的域名并返回注册商、注册时间、DNS 服务器等详细数据。无需鉴权，直接调用即可获取结果。 ## 请求说明 - **URL**：`https://api.xunjinlu.fun/api/whois/index.php` - **HTTP 方法**：GET / POST - **常用请求头**： - `Accept: application/json` ## 请求参数表 | 名称 | 类型 | 必填 | 说明 | |---------|--------|------|--------------------------| | `domain` | string | 是 | 需查询的域名（如 `google.com` 或 `https://google.com`） | ## 返回字段表 | 字段 | 类型 | 说明 | |----------------------|------------|----------------------------------------------------------------------| | `code` | integer | 状态码（200 表示成功） | | `msg` | string | 响应消息（如 "success"） | | `data.domain` | string | 查询的域名 | | `data.tld` | string | 顶级域名（如 "com"） | | `data.whois_server` | string | Whois 服务器地址 | | `data.registrar` | string | 注册商名称 | | `data.create_time` | string | 注册时间（格式：`YYYY-MM-DD HH:MM:SS`） | | `data.expire_time` | string | 过期时间 | | `data.dns_servers` | array | DNS 服务器列表 | | `data.registrant` | object | 注册人信息（含 `name`、`organization`、`country`） | | `data.raw` | string | 原始 Whois 文本 | | `api_info.developer` | string | 开发者信息（"尋鯨錄"） | ## 返回 JSON 示例 ### 成功示例 ```json { "code": 200, "msg": "success", "data": { "domain": "google.com", "tld": "com", "whois_server": "whois.verisign-grs.com", "registrar": "MarkMonitor Inc.", "create_time": "1997-09-15 09:00:00", "dns_servers": ["ns1.google.com", ...], "registrant": {"name": "Domain Administrator", ...}, "raw": "Domain Name: google.com\n..." }, "api_info": {...} } ``` ### 失败示例 ```json { "code": 400, "msg": "Invalid domain format" } ``` ## 错误与状态 - `200`：成功 - `400`：请求参数错误（如域名格式无效） - `404`：域名未找到 - 其他错误码以实际返回的 `msg` 为准。 ## 调用示例 ### 直接访问 ``` https://api.xunjinlu.fun/api/whois/index.php?domain=google.com ``` ### cURL ```bash curl -X GET "https://api.xunjinlu.fun/api/whois/index.php?domain=google.com" ``` ### Python requests ```python import requests url = "https://api.xunjinlu.fun/api/whois/index.php" params = {"domain": "google.com"} response = requests.get(url, params=params) print(response.json()) ``` ### PHP ```php ``` ### HTML ```html ```