99.99%
可用性
面向生产的端点按 99.99% 可用性和已记录的状态处理方式设计。
分类
OSINT
API 端点
1
主要功能
8
常见问题解答
4
被出色公司的人们使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
10,000
免费额度
从每月 10,000 积分开始，只有在用量增长时再升级。
这个 API 可以帮你交付什么
把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
一次认证
使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。
用示例查询
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
运行和监控
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前，快速查看输入、输出字段和状态码。
参数
query
响应示例
querytypestatusrdaprdap.objectClassNamerdap.handlerdap.namerdap.startAddressrdap.endAddressrdap.ipVersion
HTTP 状态码
200400402429500502503504
API 端点
GET
/v1/rdap
query
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
可用性
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
免费额度
免费注册
从每月 10,000 积分开始，只有在用量增长时再升级。
活跃
请求示例
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
主要功能
原生 RDAP 支持
直接查询 RDAP 服务器，而非抓取的 WHOIS 数据。
结构化 JSON
遵循 RDAP 标准的机器可读响应。
注册局状态码
获取 EPP 状态码如 clientTransferProhibited。
事件数据
注册、到期和最后更新时间戳。
IANA 引导
通过 IANA 引导自动路由到正确的 RDAP 服务器。
可用性检测
准确判断域名是否可注册。
智能缓存
可配置 TTL 的智能缓存以获得最佳性能。
错误处理
RDAP 服务器暂时不可用时的优雅降级。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap?query=example.com"curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap?type=ip&query=8.8.8.8"curl -G -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap" \
--data "type=ip" \
--data-urlencode "query=2001:4860:4860::8888/128"curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/rdap?type=autnum&query=AS174"响应示例
{
"query": "8.8.8.8",
"type": "ip",
"status": "found",
"rdap": {
"objectClassName": "ip network",
"handle": "NET-8-8-8-0-2",
"name": "LVLT-GOGL-8-8-8",
"startAddress": "8.8.8.0",
"endAddress": "8.8.8.255",
"ipVersion": "v4"
}
}常见问题解答
什么是 RDAP？
RDAP（注册数据访问协议）是 WHOIS 的现代替代方案。它提供结构化的 JSON 响应、更好的国际化支持，是域名注册数据的 IETF 标准。
RDAP 与 WHOIS 有什么不同？
RDAP 返回结构化的 JSON 而非自由格式文本，支持 HTTPS 以保证安全，正确处理国际字符，并在所有注册局提供标准化的响应格式。
你们缓存 RDAP 响应吗？
是的，我们实现了智能缓存以提供快速响应并减少 RDAP 服务器负载。需要时使用 skip_cache=1 强制进行新查询。
你们查询哪些 RDAP 服务器？
我们使用 IANA RDAP 引导自动将查询路由到每个顶级域的正确权威 RDAP 服务器。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
成功
200
请求成功
请求错误
400
参数无效
需要付款
402
没有足够额度来执行此请求。
请求过多
429
超出速率限制
服务器错误
500
内部错误
网关错误
502
上游 RDAP 错误
服务不可用
503
上游服务不可用或正在临时限流。
网关超时
504
上游查询已超时。
立即访问 RDAP 数据