面向生产的端点按 99.99% 可用性和已记录的状态处理方式设计。
被出色公司的人们使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
这个 API 可以帮你交付什么
把此页面当作生产集成简报:端点、示例、响应结构,以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本,而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
使用文档中的请求头发送 API 密钥,并在服务之间保持请求一致。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前,快速查看输入、输出字段和状态码。
参数
响应示例
HTTP 状态码
API 端点
/v1/profile
/v1/overview
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
主要功能
直接查询权威 RDAP 服务器以获取准确数据。
干净的结构化 JSON,字段名称一致。
为您计算域名年龄(天数)和到期天数。
在 RDAP 数据中可用时获取注册商名称。
为域名配置的名称服务器列表。
了解域名是否启用了 DNSSEC。
EPP 状态代码,如 clientTransferProhibited。
注册、过期和更新事件及其日期。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/profile?domain=example.com"
响应示例
{
"domain": "example.com",
"registered": true,
"registrar": "Example Registrar Inc.",
"created_date": "1995-08-14T04:00:00Z",
"updated_date": "2024-08-14T07:01:34Z",
"expiry_date": "2025-08-13T04:00:00Z",
"age_days": 10745,
"days_until_expiry": 220,
"status": ["clientDeleteProhibited", "clientTransferProhibited"],
"nameservers": ["ns1.example.com", "ns2.example.com"],
"dnssec": true,
"events": [
{"action": "registration", "date": "1995-08-14T04:00:00Z"},
{"action": "expiration", "date": "2025-08-13T04:00:00Z"}
],
"raw_rdap_link": "https://rdap.verisign.com/com/v1/domain/example.com"
}
常见问题解答
此 API 使用 RDAP,这是 WHOIS 的现代替代方案。RDAP 提供结构化 JSON 响应而不是自由文本,使其更容易解析和以编程方式使用。
RDAP 响应因注册表而异。某些注册表提供的数据比其他注册表更多。GDPR 等隐私法规也减少了暴露的个人数据量。
API 返回 registered: false,状态、名称服务器和事件的空数组。这对于可用性检查很有用。
由于隐私法规,大多数 RDAP 服务器不再暴露个人注册者信息。该 API 专注于技术注册数据。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求成功
参数无效
没有足够额度来执行此请求。
超出速率限制
内部错误
上游 RDAP 错误
上游服务不可用或正在临时限流。
上游查询已超时。
获取域名资料数据