API 文档

开放接口 · 免登录直接调用 · 支持跨域(CORS)
← 返回查询

通用说明

所有接口均返回 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 分钟

域名查询

GET/api/whois/{domain}

Whois / RDAP 查询(RDAP 优先,不支持时回退 TCP 43 Whois)。返回注册商、注册人姓名/邮箱/地址、注册/到期时间、域名年龄(ageDays)剩余到期天数(expireDays)、DNS 服务器、状态、同后缀价格。

POST/api/batch

批量可注册检测(一次最多 20 个域名,RDAP 并行)。Body:{ "text": "a.com\nb.net" }{ "domains": ["a.com","b.net"] }。返回每个域名的 available / registered / error 状态。

GET/api/dns/{domain}?lines=local,cloudflare,google,alidns

多线路 DNS 查询,返回 A/AAAA/CNAME/MX/NS/TXT/SOA/CAA 记录。

GET/api/subdomains/{domain}

子域名发现(crt.sh 证书透明度日志),返回子域名列表(最多 500 条)。

IP / ASN 查询

GET/api/ip/{query}

query 为 IP 地址(IPv4/IPv6)或 AS 号(13335 / AS13335)。基于 RIR RDAP 返回网段/AS 名称、国家、所属注册机构(RIR)、滥用举报联系方式。

体检工具

GET/api/mail-check/{domain}

邮箱体检:检测域名 SPF / DKIM(常见选择器探测)/ DMARC 记录,含 SPF 查询次数统计与建议。

GET/api/site-check/{domain}

网站体检:HTTPS 可达性、重定向链、SSL 证书(颁发者/有效期/剩余天数)、6 项安全响应头(HSTS/CSP 等)。

价格数据

GET/api/tld?search=&sort=reg|renew|transfer|tld&order=asc|desc&page=1&pageSize=50

后缀价格百科:3000+ 后缀的注册/续费/转入最低价(每小时刷新快照)。

GET/api/price/{tld}

单个后缀实时价格。

GET/api/price-history/{tld}?days=90

后缀价格历史(7-365 天),返回按日归档的注册/续费/转入价格序列,可用于绘制趋势图。

其他

GET/api/site

站点公开设置(站名、公告、页脚等)。

GET/api/sponsors

赞助名单。

POST/api/feedback

提交反馈。Body:{ "type": "bug|suggestion|other", "content": "内容", "contact": "联系方式" }

调用示例

curl

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"

JavaScript(浏览器,跨域可用)

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/*)不开放跨域。