所有接口均返回 JSON,格式为 { "success": true, ... } 或 { "success": false, "error": "错误说明" }。
| 项目 | 说明 |
|---|---|
| 基础地址 | https://你的域名/api |
| 跨域支持 | 公开接口均带 CORS 头,可直接从第三方网页调用(预检 OPTIONS 自动返回 204) |
| 匿名限流 | Whois 30 次/分钟、DNS 40 次/分钟、工具类 20 次/分钟、批量检测 6 次/10 分钟、反馈 5 次/10 分钟 |
| API Key | 请求头 X-Api-Key: 你的Key 可将 Whois 限流提升至 Key 配置额度(默认 120 次/分钟,后台可调 30-600) |
| 数据缓存 | Whois 结果缓存 10 分钟;子域名 12 小时;邮箱体检 1 小时;网站体检 30 分钟 |
Whois / RDAP 查询(RDAP 优先,不支持时回退 TCP 43 Whois)。返回注册商、注册人姓名/邮箱/地址、注册/到期时间、域名年龄(ageDays)、剩余到期天数(expireDays)、DNS 服务器、状态、同后缀价格。
批量可注册检测(一次最多 20 个域名,RDAP 并行)。Body:{ "text": "a.com\nb.net" } 或 { "domains": ["a.com","b.net"] }。返回每个域名的 available / registered / error 状态。
多线路 DNS 查询,返回 A/AAAA/CNAME/MX/NS/TXT/SOA/CAA 记录。
子域名发现(crt.sh 证书透明度日志),返回子域名列表(最多 500 条)。
query 为 IP 地址(IPv4/IPv6)或 AS 号(13335 / AS13335)。基于 RIR RDAP 返回网段/AS 名称、国家、所属注册机构(RIR)、滥用举报联系方式。
邮箱体检:检测域名 SPF / DKIM(常见选择器探测)/ DMARC 记录,含 SPF 查询次数统计与建议。
网站体检:HTTPS 可达性、重定向链、SSL 证书(颁发者/有效期/剩余天数)、6 项安全响应头(HSTS/CSP 等)。
后缀价格百科:3000+ 后缀的注册/续费/转入最低价(每小时刷新快照)。
单个后缀实时价格。
后缀价格历史(7-365 天),返回按日归档的注册/续费/转入价格序列,可用于绘制趋势图。
站点公开设置(站名、公告、页脚等)。
赞助名单。
提交反馈。Body:{ "type": "bug|suggestion|other", "content": "内容", "contact": "联系方式" }。
curl "https://你的域名/api/whois/example.com"
curl -X POST "https://你的域名/api/batch" \
-H "Content-Type: application/json" \
-d '{"text":"a.com\nb.net\nc.org"}'
curl "https://你的域名/api/whois/example.com" \
-H "X-Api-Key: wh_xxxxxxxxxxxx"
fetch('https://你的域名/api/whois/example.com')
.then(r => r.json())
.then(j => {
if (j.success) {
console.log('注册商:', j.whois.registrar?.name);
console.log('注册人:', j.whois.registrant?.name);
console.log('域名年龄:', j.whois.ageDays, '天');
console.log('剩余到期:', j.whois.expireDays, '天');
}
});
注:API Key 在管理后台「API Key」页创建,明文仅显示一次。管理接口(/api/admin/*)不开放跨域。