域名 Whois API

查询域名注册信息

GET /api/whois

请求参数

• domain（必填）：域名，例如 example.com，示例 github.com

返回字段

• domain（string）：域名的 ASCII 形式（小写，中文域名为 punycode，如 xn--fsqu00a.xn--fiqs8s）
• unicodeName（string|null）：域名的 Unicode 形式（如 例子.中国），通常只有中文等国际化域名才有；RDAP 未提供时为 null
• handle（string|null）：注册局为该域名分配的对象 ID（如 2138514_DOMAIN_COM-VRSN）；RDAP 未提供时为 null
• registrar（object|null）：注册商信息；RDAP 中没有角色为 registrar 的实体时为 null
• registrar.name（string|null）：注册商名称（vCard 的 fn）；没有时退回注册商实体的 handle（通用顶级域通常就是 IANA 编号）；都没有时为 null
• registrar.ianaId（string|null）：IANA 注册商编号（数字字符串，如 292）；RDAP 未提供时为 null（国家和地区顶级域较常见）
• registrar.url（string|null）：注册商链接：取注册商实体 links 中第一个 rel 为 about 或 related 的地址（可能是注册商官网，也可能是其 RDAP 查询地址）；没有时为 null
• registrar.abuseEmail（string|null）：注册商的滥用投诉邮箱；未提供时为 null
• registrar.abusePhone（string|null）：注册商的滥用投诉电话（已去掉 tel: 前缀，如 +1.2086851750）；未提供时为 null
• status（array）：域名状态列表，为 RDAP 状态值（由 EPP 状态码转换而来，全小写、单词间用空格）；RDAP 未提供时为空数组
• status[]（string）：单个状态值。常见取值：active 正常；inactive 未设置 DNS 服务器（无法解析）；client/server delete prohibited 禁止删除；client/server transfer prohibited 禁止转移到其他注册商；client/server update prohibited 禁止修改注册信息；client/server renew prohibited 禁止续费；client/server hold 暂停解析（域名无法访问）；pending create/delete/renew/restore/transfer/update 对应操作正在处理；redemption period 赎回期（已过期并进入删除流程，仍可赎回）；add period / auto renew period / renew period / transfer period 注册、自动续费、续费、转移后的宽限期。client 开头的由注册商设置，server 开头的由注册局设置；各类 prohibited 多为防止被盗转的保护锁，不代表域名异常
• created（string|null）：注册时间（RDAP registration 事件），统一为 ISO 8601 UTC 格式（如 1997-09-15T04:00:00.000Z）；RDAP 未提供时为 null
• updated（string|null）：注册信息最后修改时间（RDAP last changed 事件，不是 RDAP 数据库的刷新时间），格式同 created；未提供时为 null
• expires（string|null）：到期时间（RDAP expiration 或 registrar expiration 事件），格式同 created；未提供时为 null
• nameservers（array）：DNS 服务器域名列表（小写，如 ns1.google.com）；没有设置 DNS 服务器时为空数组
• dnssec（boolean|null）：是否启用 DNSSEC（RDAP secureDNS.delegationSigned）：true 已启用，false 未启用；RDAP 未提供时为 null