API 文档

v1.6

Next Whois 提供简单的 REST API，用于程序化 WHOIS/RDAP 查询和动态 OG 图像生成。所有端点均公开访问，无需认证。

GET
/api/lookup

查询域名、IP 地址、ASN 或 CIDR 范围的 WHOIS/RDAP 信息。RDAP 和 WHOIS 并行查询；结构化字段优先使用 RDAP 数据，回退到 WHOIS。两种原始响应均包含在内。

参数

参数类型必填默认值描述
querystring
必填
—域名、IPv4/IPv6 地址、ASN（如 AS13335）或 CIDR 范围。别名：q

请求示例

curl "https://your-domain.com/api/lookup?query=google.com"

成功响应

{
  "status": true,
  "time": 1.23,
  "cached": false,
  "source": "rdap",
  "result": {
    "domain": "google.com",
    "registrar": "MarkMonitor Inc.",
    "registrarURL": "http://www.markmonitor.com",
    "ianaId": "292",
    "whoisServer": "whois.markmonitor.com",
    "creationDate": "1997-09-15T04:00:00Z",
    "expirationDate": "2028-09-14T04:00:00Z",
    "updatedDate": "2019-09-09T15:39:04Z",
    "status": [
      { "status": "clientDeleteProhibited", "url": "..." },
      { "status": "clientTransferProhibited", "url": "..." }
    ],
    "nameServers": ["ns1.google.com", "ns2.google.com", "ns3.google.com", "ns4.google.com"],
    "dnssec": "unsigned",
    "domainAge": 28,
    "remainingDays": 945,
    "rawWhoisContent": "Domain Name: GOOGLE.COM\nRegistry Domain ID: ...",
    "rawRdapContent": "{\n  \"objectClassName\": \"domain\",\n  ...\n}"
  }
}

错误响应

{
  "status": false,
  "time": 0.45,
  "error": "No match for domain \"EXAMPLE.INVALID\""
}
GET
/api/og

生成包含 WHOIS 详情的动态 Open Graph 图像。内部查询 /api/lookup 并渲染卡片式摘要。返回 PNG 图像。

参数

参数类型必填默认值描述
querystring
可选
—要查询和显示的域名、IP、ASN 或 CIDR。别名：q
wnumber
可选
1200图像宽度（像素，200-4096）
hnumber
可选
630图像高度（像素，200-4096）
themestring
可选
light颜色主题："light" 或 "dark"

请求示例

curl "https://your-domain.com/api/og?query=google.com&theme=dark" -o og.png

预览

OG Image Preview

/api/og?query=google.com

速率限制与缓存
成功的 WHOIS 查询响应会在服务器端缓存（Redis），并附带
Cache-Control: s-maxage=3600, stale-while-revalidate=86400
头部。
缓存的响应包含
"cached": true
在 JSON 正文中，并报告
"time": 0
.

Next Whois v1.6 · GitHub