开发者更新

API 更新日志

跟踪重大变更、新功能和弃用通知。我们会在进行重大变更前通知开发者。

v2.11.0 2026年4月14日 功能

API 指南和定价刷新

  • 添加了专用的 API 定价页面,其中包含更清晰的 endpoint pricing、billing 链接和计划指南
  • 本地化 API 指南页面现在共享一个统一的 layout ,其中包含设置步骤、示例和后续操作
  • 扩大了 API 参考覆盖范围,因此更多公共 endpoints 拥有专用指南页面,而不是仅索引列表
  • 改进了跨指南示例的 MCP 设置登录页面和开发人员操作
  • 指南和文档页面现在更积极地绕过过时页面 cache ,因此更新速度更快
v2.10.1 2026年4月9日 修复

可用性信心和 ccTLD 后备方案

  • 可用性响应现在包含 `confidence` 字段,以区分权威注册表答案和启发式 fallbacks
  • 添加了对 `.es` 和限制直接可用性检查的类似注册表的 DNS 和 WHOIS fallback 处理
  • 修复了当 RDAP 在请求中失败时 `skipCache` 模式丢弃结果的问题
  • 改进了对拒绝访问 RDAP 响应和瞬态注册表抑制 caches 的处理
v2.10.0 2026年4月2日 改进

WHOIS 回退扩展

  • TLD 验证现在使用所有路由的实时 IANA 引导数据
  • 为没有 RDAP 引导程序覆盖范围的 TLD 以及无法访问 RDAP 服务器的注册管理机构添加了 WHOIS fallback
  • 对于不受支持的 TLD,批量状态检查现在可以回退到 WHOIS,而不是提前失败
  • WHOIS 可用性解析现在可以识别更多的多语言注册表响应
  • 对于私有和保留 IP 范围,`/v1/ip` 现在返回 HTTP 400,而不是 500
v2.9.0 2026年3月29日 改进

数据质量和性能升级

  • 改进了 Spamhaus、技术检测、SSL 和跨多种智能的声誉结果质量 endpoints
  • 扩展了 KV caching 并统一了解析器和超时处理,以实现低延迟查找
  • 改进了批量状态错误报告并将 OpenAPI 身份验证示例与生产行为保持一致
  • 跨 API 登陆页面刷新公共文档和本地化元数据
v2.8.0 2026年3月3日 功能

网站分类API大修

  • 网站分类现在使用具有多信号评分的 IAB-inspired 分类法
  • 回复包括排名较高的类别、子类别和 confidence 分数
  • 添加了批量分类支持和 caching 以进行较大的分析作业
  • 文档和 OpenAPI 示例现在反映了更丰富的分类响应和 confidence 阈值
v2.7.0 2026年2月15日 修复

历史数据可靠性

  • 扩大被动 snapshot 记录以加强 `/v1/whois/history` 和相关历史视图
  • 修复了某些路线上因后台持久计时而导致的历史写入丢失的问题
  • 历史表现在可以随着时间的推移捕获更一致的域更改数据
  • 添加了 D1 重试处理和针对暂时性故障的批量 endpoint 修复
v2.6.0 2026年2月7日 功能

第四阶段:新功能和数据丰富

  • 新 `/v1/parking` endpoint - 通过 DNS、重定向和 HTML 分析检测停放域名和 aftermarket 列表
  • 新 `/v1/whois/history` endpoint - 使用 D1 支持的 snapshot 存储跟踪 WHOIS 随着时间的变化
  • 威胁情报现在聚合 URLhaus + Spamhaus DBL + 启发式模式
  • 域名估值基于具有可比类别的真实市场销售数据
  • 托管检测从 AWS、GCP 和 Cloudflare 获取动态 IP 范围(KV 中的 cached 24h)
  • SPF 验证现在计算递归 DNS 查找(RFC 7208 10 次查找限制)
  • 添加到 `/v1/tech` 的 Open Graph、Twitter Card 和元标记提取
  • DKIM 检查从 10 个选择器扩展到大约 50 个选择器,涵盖所有主要 ESPs
  • 当 Cloudflare 不可用时,DNS 查询现在回退到 Google DoH
  • 错误 cache 使用特定于类型的 TTL 来实现更智能的重试行为
  • 预算系统持续到KV,因此它可以生存到worker restarts
  • 添加了 IPv6、security.txt、BIMI、MTA-STS、HTTPS/SVCB、domain age 和 transfer_locked 字段
v2.5.0 2026年1月6日 功能

多货币支持

  • 为域名估值添加了 GBP 和 JPY 货币支持
  • 在 `/v1/value` 端点上添加了新的 `currency` 参数(默认:USD)
  • 估值响应现在包括 `currency` 字段
v2.4.2 2025年12月19日 改进

移动体验改进

  • 修复了移动导航 UI 问题
  • 在移动设备上为 API 文档添加了浮动导航菜单
  • 改进了终端组件的响应行为
v2.4.1 2025年12月12日 安全

安全加强

  • 增强了所有端点的输入验证
  • 为身份验证端点添加了速率限制保护
  • 改进了对用户生成内容的 XSS 保护
  • 现在在所有响应上强制执行安全标头
v2.3.0 2025年11月18日 功能

反向查找 API

  • 新的 `/v1/reverse/mx` 端点 - 按邮件服务器查找域名
  • 新的 `/v1/reverse/ip` 端点 - 查找托管在 IP 上的域名
  • 两个端点都通过 `offset` 和 `limit` 参数支持分页
  • 结果包括置信度分数和最后一次发现时间戳
v2.2.1 2025年11月8日 修复

RDAP 可靠性改进

  • 修复了某些 ccTLD 注册表的间歇性超时
  • 改进了对速率限制 RDAP 服务器的重试逻辑
  • 更好地处理格式不正确的 RDAP 响应
  • 缓存现在遵循注册表特定的 TTL 提示
v2.2.0 2025年10月28日 功能

电子邮件身份验证 API

  • 用于电子邮件安全审计的新 `/v1/email-auth` 端点
  • 验证 SPF、DKIM 和 DMARC 配置
  • 为配置错误的记录返回可操作的建议
  • 包括基于身份验证设置的可传递性分数
v2.1.0 2025年10月15日 破坏性

响应格式标准化

  • 破坏性: 错误响应现在使用一致的 `error.code` 和 `error.message` 格式
  • 破坏性: 从所有响应中移除了弃用的 `err` 字段
  • 破坏性: HTTP 429 响应现在以秒为单位包含 `retry_after`(之前是毫秒)
  • 添加了带有可操作指导的 `error.suggestion` 字段
  • 所有时间戳现在都采用 ISO 8601 格式
迁移示例
// Before (v2.0.x)
{ "err": "rate limited", "retry": 5000 }

// After (v2.1.0+)
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests",
    "suggestion": "Reduce request frequency or upgrade plan",
    "retry_after": 5
  }
}
v2.0.3 2025年10月2日 修复

批量端点稳定性

  • 修复了批量状态检查中的竞态条件,导致重复结果
  • 改进了大型批量请求的内存效率
  • 为同一批次中的相同域名添加了请求重复数据删除
v2.0.2 2025年9月22日 改进

性能优化

  • 通过边缘缓存改进,将平均响应时间缩短了 35%
  • 通过连接池优化了 DNS 解析
  • Bootstrap 数据现在在后台刷新,不阻止请求
v2.0.1 2025年9月10日 修复

IDN 域名处理

  • 修复了国际化域名的 punycode 转换
  • 改进了混合脚本域名标签的验证
  • 添加了对具有非 ASCII 字符的新 gTLD 的支持
v2.0.0 2025年9月1日 破坏性

API v2 推出

  • 破坏性: 所有端点从 `/api/` 前缀移动到 `/v1/` 前缀
  • 破坏性: 身份验证现在需要在 `X-API-Key` 标头中使用 API 密钥(之前是查询参数)
  • 破坏性: 速率限制现在基于密钥而不是基于 IP 的每密钥,用于身份验证请求
  • 新的域名可用性引擎,查找速度快 40%
  • 添加了对 400+ 个新 TLD 的支持
  • 推出了基于信用的定价模式
  • 为 API 密钥管理新建仪表板
迁移示例
// Before (v1.x)
GET /api/check?domain=example.com&key=xxx

// After (v2.0+)
GET /v1/status?name=example&tlds=com
Headers: X-API-Key: xxx
v1.5.0 2025年8月18日 功能

技术栈检测

  • 用于网站技术检测的新 `/v1/tech` 端点
  • 识别 CDN 提供商、CMS 平台、框架和分析工具
  • 基于 HTTP 标头、HTML 模式和 JavaScript 指纹的检测
v1.4.0 2025年8月5日 功能

域名健康检查器

  • 用于全面域名健康检查的新 `/v1/health` 端点
  • 验证 DNS 配置、SSL 证书和安全标头
  • 为轻量级检查添加了 `/v1/health/quick`(仅限 DNS)
  • 域名资料响应中现在包括健康评分
v1.3.2 2025年7月28日 修复

证书透明性改进

  • 修复了具有 1000+ 个证书的域名的分页
  • 添加了通配符证书检测
  • 改进了对非标准发行者的证书解析
v1.3.1 2025年7月20日 弃用

弃用通知

  • 已弃用:`/api/*` 端点将在 v2.0 中移除(2025年9月)
  • 已弃用: 查询参数身份验证(`?key=xxx`)将在 v2.0 中移除
  • 在响应标头中为受影响的端点添加了弃用警告
  • 迁移指南可在 /docs#migration-v2 获取
v1.3.0 2025年7月12日 功能

域名抢注检测

  • 用于品牌保护的新 `/v1/typos` 端点
  • 检测基于键盘的打字错误、同形字攻击和 TLD 变体
  • 基于注册状态和内容相似性的威胁评分
  • 新注册的域名抢注域名的 Webhook 通知

获取重大变更通知

订阅以在重大变更发布前接收邮件提醒。