域名 Whois 查询

返回公开登记资料，不代表设备位置或域名当前可注册。注册人隐私保护和未披露资料保留 null 或合法空值，不推断隐藏身份。保留已有日期字符串格式和数组顺序。最多 7 天的备用资料可能较旧，登记日期不是请求时间。
按域名查询公开登记资料，便于整理域名资产档案。
查询注册商名称，辅助核对注册服务机构。
返回来源公开的创建日期，作为登记时间参考。
返回来源公开的到期日期，便于安排续费核查。
返回登记更新时间，辅助比较保存的资料版本。
返回公开名称服务器列表，便于整理域名委派资料。
返回公开域名状态，辅助识别转移或更新限制。
返回来源公开的 DNSSEC 登记标记。
返回可公开的联系邮箱，未披露时保持空值。
整理公开组织、国家及地区资料。
按有效 IDN 或 punycode 表达查询国际化域名。
按现有登记域名规则将子域名关联到注册档案。

当前接口契约

接口详情：https://www.gugudata.com/api/details/whois

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	使用本产品已授权的 AppKey，保留现有有效鉴权方式。此鉴权位置可选；整体鉴权要求及其他已支持位置以本操作说明为准。
domain	string	是	无	域名本身，保留大小写、尾点和有效 IDN 表达；不传 URL、端口或 IP。

正常响应字段

字段	类型	说明
dataStatus.requestParameter	string	真实归一化 domain 参数，无凭据。
dataStatus.statusCode	integer	成功 200；参数错误 400；依赖失败 503。
dataStatus.status	string	保留 Java 业务状态文字。
dataStatus.statusDescription	string	业务状态说明。
dataStatus.responseDateTime	string	返回时间，保留当前字符串格式。
dataStatus.dataTotalCount	integer	顶层结果对象数量，成功为 1。
data	object	域名公开登记资料。
data.address	array(string)\|null	注册人地址。
data.city	array(string)\|null	注册城市。
data.country	string\|null	注册国家或地区代码。
data.creation_date	string\|null	域名创建时间。
data.dnssec	string\|null	DNSSEC 状态。
data.domain_name	array(string)\|null	域名名称。
data.emails	array(string)\|null	公开联系邮箱列表。
data.expiration_date	string\|null	域名过期时间。
data.name	array(string)\|null	注册人姓名。
data.name_servers	array(string)\|null	域名服务器列表。
data.org	string\|null	注册组织。
data.referral_url	string\|null	注册商参考链接。
data.registrant_postal_code	string\|null	注册人邮政编码。
data.registrar	string\|null	注册商。
data.state	string\|null	注册省份或州。
data.status	array(string)\|null	域名状态列表。
data.updated_date	array(string)\|null	域名更新时间。

业务状态说明

业务状态码	业务状态码解释	备注
200	成功	HTTP 200
400	参数错误	HTTP 400
503	处理、依赖失败或超时	HTTP 503
429	请求频率限制	HTTP 429
403	无权限或权益过期	HTTP 403
402	凭据缺失或无效	HTTP 401/403

返回响应

🟢200成功

application/json

成功（业务码 200）。

Bodyapplication/json

示例

{"dataStatus":{"requestParameter":"domain=gugudata.com","statusCode":200,"status":"SUCCESS","statusDescription":"successfully / 成功","responseDateTime":"2026-10-24 15:04:20","dataTotalCount":1},"data":{"address":["REDACTED FOR PRIVACY"],"city":["REDACTED FOR PRIVACY"],"country":"CN","creation_date":"Wed, 01 Jun 2016 06:48:32 GMT","dnssec":"unsigned","domain_name":["GUGUDATA.COM"],"emails":["supervision@xinnet.com"],"expiration_date":"Tue, 01 Jun 2027 06:48:32 GMT","name":["REDACTED FOR PRIVACY"],"name_servers":["VIP3.ALIDNS.COM","VIP4.ALIDNS.COM"],"org":"REDACTED FOR PRIVACY","referral_url":null,"registrant_postal_code":"REDACTED FOR PRIVACY","registrar":"Xin Net Technology Corporation","state":"JS","status":["clientTransferProhibited https://icann.org/epp#clientTransferProhibited","clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited","clientUpdateProhibited https://www.icann.org/epp#clientUpdateProhibited","clientTransferProhibited https://www.icann.org/epp#clientTransferProhibited"],"updated_date":["Sun, 14 Jun 2026 13:38:22 GMT","Sun, 14 Jun 2026 13:37:56 GMT"]}}

🟠400参数错误（业务码 400）。

🔴503处理、依赖失败或超时（业务码 503）。

🟠429请求频率限制（业务码 429）。

🟠403无权限或权益过期（业务码 403）；凭据缺失或无效（业务码 402）。

🟠401凭据缺失或无效（业务码 402）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明