集成前,请先查看实时服务运行状况和文档中说明的失败响应。
被这些公司的人员使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
每月 1,000 个免费积分,即刻开始。需要更多?可选择月度方案,或购买一次性积分包。
这个 API 可以帮你交付什么
把此页面当作生产集成简报:端点、示例、响应结构,以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本,而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
使用文档中的请求头发送 API 密钥,并在服务之间保持请求一致。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前,快速查看输入、输出字段和状态码。
参数
响应示例
HTTP 状态码
API 端点
/v1/status
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
集成前,请先查看实时服务运行状况和文档中说明的失败响应。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
每月 1,000 个免费积分,即刻开始。需要更多?可选择月度方案,或购买一次性积分包。
主要功能
JSON 响应替代无法解析的 WHOIS 文本。无需正则表达式。
所有 TLD 和注册局的响应格式一致。
RDAP 查询权威来源,而非过时的 WHOIS 代理。
正确处理 IDN 域名和 Unicode 字符。
查询使用安全连接,不像明文 WHOIS。
状态、日期和可用性的结构化字段。
ICANN 授权的传统 WHOIS 基础设施替代方案。
直接访问注册、到期和转移日期。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/status?name=company&tlds=com,net,org"
响应示例
{
"name": "company",
"results": [
{
"domain": "company.com",
"available": false,
"source": "rdap",
"registry_status": ["client transfer prohibited"],
"rdap_events": [
{ "eventAction": "registration", "eventDate": "1996-04-08T04:00:00Z" },
{ "eventAction": "expiration", "eventDate": "2027-04-09T04:00:00Z" }
]
}
]
}
常见问题解答
WHOIS 返回因注册局而异的非结构化文本,需要复杂的解析。RDAP 提供标准化的 JSON 响应,便于程序化处理。
是的。ICANN 已要求以 RDAP 取代 WHOIS。大多数注册局现在支持 RDAP,有些已完全弃用 WHOIS。
RDAP 以结构化格式提供注册数据。由于 GDPR 等隐私法规,WHOIS 和 RDAP 的注册人联系信息可能都有限。
DomScan 使用 RDAP,而非 WHOIS。我们专注于域名可用性检查,提供来自权威 RDAP 服务器的准确、结构化数据。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求成功
参数无效
API 密钥或会话缺失或无效。
没有足够额度来执行此请求。
超出速率限制

