接口简介：

ICANN规定：2025 年 1 月 28 日起，gTLD 注册局和注册商不再被强制要求提供传统的WHOIS服务，RDAP成为新版WHOIS信息服务，标准统一的JSON格式，替代了各家WHOIS信息格式不一致的问题。支持目前主流域名，但各国别域名等后缀管理机构尚未完全支持RDAP的方式查询。该方式可作为优先查询，如果不支持的后缀可再调用【全球域名WHOIS信息查询】接口。接口盒子采用多节点加代理辅助查询的方式，支持高并发查询。



请求地址：

https://cn.apihz.cn/api/wangzhan/whoisrdap.php



请求方式：

POST或GET。



请求参数：

【名称】【参数】【必填】【说明】

【用户ID】【id】【是】【用户中心的数字ID，例：id=10000000】

【用户KEY】【key】【是】【用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2】

【域名】【domain】【是】【要查询的域名，尽量使用主域名，不带http。例：domain=erguanmingmin.com】

【查询方式】【type】【否】【1=优先使用查询缓存，2=直接查询注册局官方，默认1。例：type=1】



返回参数：

【名称】【参数】【说明】

【状态码】【code】【200成功，400错误，403不支持该后缀，404表示没有记录，代表未注册】

【信息提示】【msg】【提示信息。】

【缓存时间】【cachetime】【该信息在接口盒子的缓存时间。】

【对象类型标识】【objectClassName】【RDAP对象类型标识，此处固定为\\\\\\\"domain\\\\\\\"表示域名对象。】

【注册局唯一编号】【handle】【域名在注册局的内部唯一编号，用于区分同一域名的不同版本。】

【域名ASCII名称】【ldhName】【域名的大写ASCII格式名称，即查询的域名主体，不含非ASCII字符。】

【链接关系类型】【links.rel】【链接的关系类型，\\\\\\\"self\\\\\\\"表示当前资源自身链接，\\\\\\\"related\\\\\\\"表示关联的注册商RDAP服务链接。】

【链接显示值】【links.value】【链接的展示文本，通常与实际访问地址一致。】

【链接访问地址】【links.href】【链接的实际HTTP/HTTPS访问地址，指向RDAP服务端点。】

【链接资源类型】【links.type】【链接返回的资源类型，固定为\\\\\\\"application/rdap+json\\\\\\\"。】

【域名状态列表】【status】【域名当前状态代码数组，包含禁止转移、禁止删除、禁止更新等管控状态。】

【实体对象类型】【entities.objectClassName】【实体对象的类型标识，此处固定为\\\\\\\"entity\\\\\\\"表示注册商/联系人实体。】

【实体唯一编号】【entities.handle】【实体的内部唯一编号，注册商实体对应IANA分配的注册商ID。】

【实体角色】【entities.roles】【实体承担的角色数组，此处为[\\\\\\\"registrar\\\\\\\"]表示注册商角色。】

【实体关联链接】【entities.links】【注册商官网或RDAP服务的关联链接集合。】

【公开标识类型】【entities.publicIds.type】【实体公开标识的类型，此处为\\\\\\\"IANA Registrar ID\\\\\\\"表示IANA注册商ID。】

【公开标识值】【entities.publicIds.identifier】【实体公开标识的具体数值，即注册商对应的IANA ID。】

【实体电子名片】【entities.vcardArray】【vCard标准格式数组，存储注册商的名称、联系方式等实体信息。】

【子实体对象类型】【entities.entities.objectClassName】【嵌套子实体的对象类型标识，固定为\\\\\\\"entity\\\\\\\"表示联系人实体。】

【子实体角色】【entities.entities.roles】【嵌套子实体承担的角色数组，此处为[\\\\\\\"abuse\\\\\\\"]表示滥用投诉联系人。】

【子实体电子名片】【entities.entities.vcardArray】【vCard格式数组，存储滥用投诉的联系电话、邮箱等信息。】

【事件动作类型】【events.eventAction】【事件的类型标识，\\\\\\\"registration\\\\\\\"表示注册，\\\\\\\"expiration\\\\\\\"表示到期，\\\\\\\"last changed\\\\\\\"表示最近信息变更，\\\\\\\"last update of RDAP database\\\\\\\"表示RDAP数据库最近更新。】

【事件发生时间】【events.eventDate】【事件对应的ISO8601格式UTC时间戳，需转换为本地时间后使用。】

【DNSSEC签名状态】【secureDNS.delegationSigned】【布尔值，表示该域名的DNSSEC是否已启用并完成委派签名。】

【域名服务器对象类型】【nameservers.objectClassName】【域名服务器对象的类型标识，固定为\\\\\\\"nameserver\\\\\\\"。】

【域名服务器主机名】【nameservers.ldhName】【域名服务器的大写ASCII格式主机名，即权威DNS服务器地址。】

【规范遵循声明】【rdapConformance】【RDAP服务器遵循的规范版本数组，标识支持的RDAP标准等级和ICANN合规要求。】

【通告标题】【notices.title】【服务通告的标题文本，如服务条款、状态码说明等。】

【通告描述内容】【notices.description】【通告的具体内容文本数组，包含详细说明信息。】

【通告关联链接】【notices.links】【通告相关的参考链接集合，指向条款详情、状态码说明等页面。】



GET请求示例：

https://cn.apihz.cn/api/wangzhan/whoisrdap.php?id=88888888&key=88888888&domain=erguanmingmin.com&type=1

注意：示例里的ID与KEY为公共ID与KEY，共享每分钟调用频次限制，接口本身免费，请使用自己的ID与KEY，独享每分钟调用频次。每日调用无上限。



POST请求示例：

请根据开发语言自行POST。



返回数据示例：

示例：{"code":400,"msg":"通讯秘钥错误。"}

示例：

{

"objectClassName": "domain",

"handle": "2562533011_DOMAIN_COM-VRSN",

"ldhName": "ERGUANMINGMIN.COM",

"links": [{

"value": "https://rdap.verisign.com/com/v1/domain/ERGUANMINGMIN.COM",

"rel": "self",

"href": "https://rdap.verisign.com/com/v1/domain/ERGUANMINGMIN.COM",

"type": "application/rdap+json"

}, {

"value": "https://rdap.dnspod.cn/domain/ERGUANMINGMIN.COM",

"rel": "related",

"href": "https://rdap.dnspod.cn/domain/ERGUANMINGMIN.COM",

"type": "application/rdap+json"

}],

"status": ["client transfer prohibited", "client update prohibited"],

"entities": [{

"objectClassName": "entity",

"handle": "1697",

"roles": ["registrar"],

"links": [{

"href": "http://www.dnspod.cn",

"type": "text/html",

"value": "https://rdap.dnspod.cn/",

"rel": "about"

}],

"publicIds": [{

"type": "IANA Registrar ID",

"identifier": "1697"

}],

"vcardArray": ["vcard", [

["version", [], "text", "4.0"],

["fn", [], "text", "DNSPod, Inc."]

]],

"entities": [{

"objectClassName": "entity",

"roles": ["abuse"],

"vcardArray": ["vcard", [

["version", [], "text", "4.0"],

["fn", [], "text", ""],

["tel", {

"type": "voice"

}, "uri", "tel:+86.4009100100"],

["email", [], "text", "dnsabuse@tencent.com"]

]]

}]

}],

"events": [{

"eventAction": "registration",

"eventDate": "2020-09-28T10:57:46Z"

}, {

"eventAction": "expiration",

"eventDate": "2026-09-28T10:57:46Z"

}, {

"eventAction": "last changed",

"eventDate": "2025-09-26T04:26:11Z"

}, {

"eventAction": "last update of RDAP database",

"eventDate": "2026-08-03T07:21:53Z"

}],

"secureDNS": {

"delegationSigned": true,

"dsData": [{

"keyTag": 5386,

"algorithm": 13,

"digestType": 2,

"digest": "0E05C8AAE43852DA1FCC872686D8AA0EB09C34F671B1F5AA7C201F536E86B689"

}]

},

"nameservers": [{

"objectClassName": "nameserver",

"ldhName": "NS3.DNSV2.COM"

}, {

"objectClassName": "nameserver",

"ldhName": "NS4.DNSV2.COM"

}],

"rdapConformance": ["rdap_level_0", "icann_rdap_technical_implementation_guide_1", "icann_rdap_response_profile_1"],

"notices": [{

"title": "Terms of Service",

"description": ["Service subject to Terms of Use."],

"links": [{

"href": "https://www.verisign.com/domain-names/registration-data-access-protocol/terms-service/index.xhtml",

"type": "text/html",

"value": "https://rdap.verisign.com/com/v1/domain/erguanmingmin.com",

"rel": "terms-of-service"

}]

}, {

"title": "Status Codes",

"description": ["For more information on domain status codes, please visit https://icann.org/epp"],

"links": [{

"href": "https://icann.org/epp",

"type": "text/html"

}]

}, {

"title": "RDDS Inaccuracy Complaint Form",

"description": ["URL of the ICANN RDDS Inaccuracy Complaint Form: https://icann.org/wicf"],

"links": [{

"href": "https://icann.org/wicf",

"type": "text/html",

"value": "https://rdap.verisign.com/com/v1/domain/erguanmingmin.com",

"rel": "help"

}]

}],

"code": 200,

"cachetime": "2026-08-03 15:22:03"

}



参考资料(版权)：

https://www.apihz.cn/api/wangzhanwhoisrdap.html