| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
| 域名 | domain | 是 | 要查询的域名,尽量使用主域名,不带http。例:domain=erguanmingmin.com |
| 查询方式 | type | 否 | 1=优先使用查询缓存,2=直接查询注册局官方,默认1。例:type=1 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | 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 | 通告相关的参考链接集合,指向条款详情、状态码说明等页面。 |
示例:{"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"
}
2026-08-04 21:50:44 - 返回字段【code】新增状态码【403】不支持该后缀,【404】代表没有记录,没有注册。2026-08-03 14:49:21 - 新增接口。
ICANN规定:2025 年 1 月 28 日起,gTLD 注册局和注册商不再被强制要求提供传统的WHOIS服务,RDAP成为新版WHOIS信息服务,标准统一的JSON格式,替代了各家WHOIS信息格式不一致的问题。支持目前主流域名,但各国别域名等后缀管理机构尚未完全支持RDAP的方式查询。该方式可作为优先查询,如果不支持的后缀可再调用【全球域名WHOIS信息查询】接口。接口盒子采用多节点加代理辅助查询的方式,支持高并发查询。
使用协议:接口盒子提供的所有服务不得用于任何违法行为。接口盒子提供的信息,使用者应当自行判断准确性,适用性。使用者所造成的一切后果责任,损失等,由使用者自行承担。从使用接口盒子的服务起默认遵守此协议。
| 调用权限 | 非定制接口直接使用 |
| 单价/次 | 免费[无上限] |
| 单日[所有用户之和] | 999999999 |
| 1分钟并发[所有用户之和] | 5000 |
| 1小时并发[所有用户之和] | 999999999 |
| 频次限制[注册用户] | 10次/分钟|每日无上限 |
| 频次限制[钻石会员] | 最高8000+次/分钟|每日无上限 |
| 频次限制[定制频次] | 联系我们定制 |
| 请求方式 | GET/POST |
| 返回格式 | JSON |
| 编码格式 | UTF-8 |
| 浏览量 | 94 |
| 今日总计调用 | 18063 |
| 昨日总计调用 | 213518 |
| 历史总计调用 | 1318316 |
| 今日排名 | 11 |
| 总排名 | 100 |
| 自检启用状态 | 未开启 |
| 自检节点 | / |
| 自检线路 | 彩钻接口线路 |
| 自检时间 | / |
| 自检耗时 | / 毫秒 |
| 自检状态 | / |
| 历史自检成功数 | / 次 |
| 历史自检失败数 | / 次 |
| 历史自检成功率 | / % |
| 今日自检成功数 | / 次 |
| 今日自检失败数 | / 次 |
| 今日自检成功率 | / % |