面向生产的端点按 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/dns/propagation
/v1/dns/servers
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
主要功能
检查全球主要DNS提供商的传播。
检查A、AAAA、CNAME、MX、TXT、NS和SOA记录。
看到您的新记录已到达的服务器的确切百分比。
验证所有服务器返回相同的值。
可选择验证记录是否与您的预期值匹配。
查看缓存过期规划的生存时间值。
监控DNS服务器性能和延迟。
了解您正在检查哪些DNS提供商和位置。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/dns/propagation?domain=example.com&type=A"
响应示例
{
"domain": "example.com",
"record_type": "A",
"propagation_percentage": 100,
"fully_propagated": true,
"consistent": true,
"unique_values": ["93.184.216.34"],
"results": [
{
"server": { "name": "Cloudflare US", "ip": "1.1.1.1", "location": "Global Anycast" },
"success": true,
"records": ["93.184.216.34"],
"ttl": 86400,
"response_time_ms": 12
},
{
"server": { "name": "Google US", "ip": "8.8.8.8", "location": "Global Anycast" },
"success": true,
"records": ["93.184.216.34"],
"ttl": 86400,
"response_time_ms": 15
}
],
"summary": {
"total_servers": 13,
"successful": 13,
"failed": 0,
"matching_expected": 13
}
}
常见问题解答
DNS传播通常需要1-48小时,具体取决于TTL值和缓存。我们的工具可帮助您实时监控进度。
不同的DNS服务器根据TTL缓存记录不同时间。某些服务器可能仍具有旧的缓存值,而其他服务器已更新。
我们检查主要的DNS提供商,包括Cloudflare(1.1.1.1)、Google(8.8.8.8)、Quad9(9.9.9.9)、OpenDNS以及美国、欧洲和亚太地区的区域服务器。
在进行更改之前降低TTL值,等待旧TTL过期,然后进行更改。传播后,您可以再次增加TTL以获得更好的缓存。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求成功
参数无效
没有足够额度来执行此请求。
超出速率限制
内部错误
上游 RDAP 错误
上游服务不可用或正在临时限流。
上游查询已超时。
立即检查DNS传播