健康检查

服务存活探测

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/whois/ping JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，成功固定为 200
msg	string	返回消息，固定为 pong
data	object	业务数据
data.version	string	服务版本号
data.time	string	服务器 UTC 时间 (Y-m-d H:i:s)
data.types	array	支持的查询类型（仅 domain）
data.types[]	string	类型：domain
data.batch_limit	integer	批量查询单次最大条数
data.supported_formats	array	支持的输出格式
data.supported_formats[]	string	格式：json / yaml / xml（仅 json 可用）

请求示例

返回示例

{"msg":"pong","code":200,"data":{"time":"2026-10-25 02:44:42","types":["domain"],"version":"1.0","batch_limit":10,"supported_formats":["json","yaml","xml"]}}

接口说明

查询单个域名的 WHOIS 信息

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/whois/query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
q	string	是	待查询域名，必填；缺失 → 400（缺少参数），超过 253 字符 → 400
type	string	否	查询类型，仅支持 domain；传其它值 → 400（type 无效）；缺省按 domain 处理
force	boolean	否	为 true 时跳过缓存强制回源查询
format	string	否	返回格式，仅 json 有效；yaml / xml 经网关返回 502（返回数据解析失败）
fields	string	否	仅返回 data 层指定字段，多个字段用英文逗号分隔

返回参数说明

参数名	类型	说明
code	integer	状态码，成功固定为 200
msg	string	返回消息，成功为 ok
data	object	业务数据
data.registered	boolean	是否已注册
data.registrar	object	域名注册商（域名查询返回）
data.registrar.name	string	注册商名称
data.registrar.handle	string	注册商编号
data.registrar.iana_id	string	IANA 编号，可能为 null
data.registrar.url	string	注册商链接，可能为 null
data.status	array	域名状态（域名查询返回）
data.status[]	string	状态项
data.creation_date	string	创建日期（ISO 8601）
data.expiration_date	string	到期日期（ISO 8601）
data.updated_date	string	更新日期（ISO 8601）
data.name_servers	array	域名服务器列表
data.name_servers[]	string	域名服务器
data.secureDNS	object	DNSSEC 信息
data.secureDNS.delegationSigned	boolean	是否启用 DNSSEC 委派签名
data.secureDNS.dsData	array	DS 记录列表
data.secureDNS.dsData[]	object	DS 记录
data.secureDNS.dsData[].keyTag	integer	密钥标签
data.secureDNS.dsData[].algorithm	integer	算法编号
data.secureDNS.dsData[].digestType	integer	摘要类型
data.secureDNS.dsData[].digest	string	摘要值
data.cached	boolean	是否命中缓存
data.stale	boolean	是否为过期兜底数据
data.queried_at	string	数据查询时间
data.query	string	查询内容
data.type	string	查询类型

请求示例

返回示例

{"msg":"ok","code":200,"data":{"type":"domain","query":"example.com","stale":false,"cached":false,"status":["client delete prohibited","client transfer prohibited","client update prohibited"],"registrar":{"url":null,"name":"RESERVED-Internet Assigned Numbers Authority","handle":"376","iana_id":null},"secureDNS":{"dsData":[{"digest":"C988EC423E3880EB8DD8A46FE06CA230EE23F35B578D64E78B29C3E1C83D245A","keyTag":2371,"algorithm":13,"digestType":2}],"delegationSigned":true},"queried_at":"2026-10-25T02:42:36+08:00","registered":true,"name_servers":["elliott.ns.cloudflare.com","hera.ns.cloudflare.com"],"updated_date":"2026-10-24T18:42:34Z","creation_date":"1995-08-14T04:00:00Z","expiration_date":"2027-08-13T04:00:00Z"}}

批量查询

批量查询域名 WHOIS，最多 10 条

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

POST http://www.shujuyu.cn/v1/api/whois/batch JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
queries	array	是	域名数组，最多 10 条，超出返回 4006；重复项自动去重；非域名项（含 IP / ASN）自动跳过；全部无效 → 400（queries 无有效元素）
force	boolean	否	为 true 时跳过缓存强制回源查询

返回参数说明

参数名	类型	说明
code	integer	状态码，成功固定为 200
msg	string	返回消息
data	object	业务数据
data.code	integer	业务状态码，0 表示成功（不是 200）
data.msg	string	业务消息
data.total	integer	提交的查询条数（含重复项）
data.returned	integer	去重后实际处理并返回的条数
data.error_count	integer	失败条数
data.elapsed_ms	integer	服务端处理耗时（毫秒）
data.list	array	查询结果列表，顺序与去重后的输入一致
data.list[]	object	单条查询结果
data.list[].code	integer	单条业务状态码，0 表示成功；失败时为业务错误码（如 5001 表示未注册）
data.list[].msg	string	单条消息
data.list[].error	string	失败原因，仅失败项存在
data.list[].query	string	查询内容，仅失败项存在
data.list[].type	string	查询类型，仅失败项存在
data.list[].registered	boolean	是否已注册，仅失败项存在
data.list[].data	object	业务数据
data.list[].data.registered	boolean	是否已注册
data.list[].data.query	string	查询内容
data.list[].data.type	string	查询类型
data.list[].data.cached	boolean	是否命中缓存
data.list[].data.stale	boolean	是否为过期兜底数据
data.list[].data.status	array	域名状态（域名查询返回）
data.list[].data.status[]	string	状态项
data.list[].data.registrar	object	域名注册商（域名查询返回）
data.list[].data.registrar.name	string	注册商名称
data.list[].data.registrar.handle	string	注册商编号
data.list[].data.registrar.iana_id	string	IANA 编号，可能为 null
data.list[].data.registrar.url	string	注册商链接，可能为 null
data.list[].data.secureDNS	object	DNSSEC 信息
data.list[].data.secureDNS.delegationSigned	boolean	是否启用 DNSSEC 委派签名
data.list[].data.secureDNS.dsData	array	DS 记录列表
data.list[].data.secureDNS.dsData[]	object	DS 记录
data.list[].data.secureDNS.dsData[].keyTag	integer	密钥标签
data.list[].data.secureDNS.dsData[].algorithm	integer	算法编号
data.list[].data.secureDNS.dsData[].digestType	integer	摘要类型
data.list[].data.secureDNS.dsData[].digest	string	摘要值
data.list[].data.creation_date	string	创建日期
data.list[].data.expiration_date	string	到期日期
data.list[].data.updated_date	string	更新日期
data.list[].data.name_servers	array	域名服务器列表
data.list[].data.queried_at	string	单条数据的查询时间
data.list[].cached	boolean	该条结果是否命中缓存
data.list[].queried_at	string	该条请求的处理时间
data.errors	array	未能取得结果的查询列表
data.errors[]	object	单条失败记录
data.errors[].query	string	查询内容
data.errors[].error	string	失败原因
data.list[].data.name_servers[]	string	域名服务器

请求示例

返回示例

{"msg":"success","code":200,"data":{"msg":"ok","code":0,"list":[{"msg":"ok","code":0,"data":{"type":"domain","query":"example.com","stale":false,"cached":false,"status":["client delete prohibited","client transfer prohibited","client update prohibited"],"registrar":{"url":null,"name":"RESERVED-Internet Assigned Numbers Authority","handle":"376","iana_id":null},"secureDNS":{"delegationSigned":true},"queried_at":"2026-10-25T02:40:40+08:00","registered":true,"name_servers":["elliott.ns.cloudflare.com","hera.ns.cloudflare.com"],"updated_date":"2026-10-24T18:40:49Z","creation_date":"1995-08-14T04:00:00Z","expiration_date":"2027-08-13T04:00:00Z"},"cached":true,"queried_at":"2026-10-25T02:42:09+08:00"},{"msg":"ok","code":0,"data":{"type":"ip","query":"8.8.8.8","stale":false,"cached":false,"queried_at":"2026-10-25T02:40:43+08:00","registered":true},"cached":true,"queried_at":"2026-10-25T02:42:09+08:00"}],"total":3,"errors":[],"returned":3,"elapsed_ms":2,"error_count":0}}

产品说明

产品概述

域名/IP/ASN WHOIS 查询服务，支持单个与批量查询，结果稳定。

使用场景

数据查询：快速集成 WHOIS 查询到您的应用中

业务系统：将 WHOIS 查询数据嵌入业务流程

开发工具：通过 API 接口获取网络工具数据

数据分析：基于 WHOIS 查询数据进行分析和决策

费用计算

按次计费单价

¥0.002 / 次

每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣

扣费优先级

免费额度

次数包

余额扣费

计费方式详解

1 免费额度

· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。

2 次数包

预付费购买固定调用次数，最高可省 20%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。

3 余额扣费

按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：个人版9折专业版8折企业版7折
量折扣：月付费调用 ≥1000 次享 2%、月付费调用 ≥10000 次享 5%、月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。

次数包方案

方案名称	调用次数	价格	折算单价	比按次付费节省	有效期
100次调用包	100 次	¥0.2	¥0.0020/次	-	365 天
500次调用包	500 次	¥0.95	¥0.0019/次	省5%	365 天
1000次调用包	1000 次	¥1.8	¥0.0018/次	省10%	365 天
5000次调用包	5000 次	¥8.5	¥0.0017/次	省15%	365 天
10000次调用包	10000 次	¥16	¥0.0016/次	省20%	365 天

VIP 权益对比

等级	每月免费次数	本接口月免费上限	折扣	VIP 折后单价
免费版	按接口配置	—	-	¥0.002/次
个人版	5000 次	5000 次	10%	¥0.0018/次
专业版	30000 次	30000 次	20%	¥0.0016/次
企业版推荐	200000 次	200000 次	30%	¥0.0014/次

* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。

费用计算示例

* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。

示例1：普通用户按次付费

调用 1000 次，费用 = 0.002 × 1000 = ¥2.00

示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）

调用 1000 次，折扣约 10%，费用 = 0.002 × (1 - 10%) × 1000 ≈ ¥1.80

示例3：购买「500次调用包」次数包

支付 ¥0.95，获得 500 次调用，折算单价 ¥0.0019/次

同等次数按次付费需 ¥1.00，次数包可节省 ¥0.05

错误码说明

错误码	说明	解决方案
200	请求成功	-
400000	请求参数错误	检查参数名、格式与取值
401000	认证失败	检查 Authorization: Bearer 密钥是否正确、是否过期
402000	账户余额不足	充值后重试
403000	无访问权限	确认密钥权限、接口范围与 IP 白名单是否满足要求
404001	接口或端点不存在	检查 API 与端点的请求路径
409000	请求冲突	请稍后重试
422000	参数校验失败	检查参数格式与取值
429000	请求频率或额度超限	降低调用频率，或升级套餐提升额度
500000	服务器内部错误	携带响应中的 request_id 联系技术支持
502000	服务暂时不可用	稍后重试
503000	服务暂时不可用	稍后重试
504000	请求超时	稍后重试

更新日志

暂无更新日志