跳转到内容
POST AI agent ready /v1/dns/propagation

DNS 传播检查 API - 免费全局解析器测试

查询某个域的多个公共 DNS 解析器（Google、Cloudflare、Quad9）并报告结果是否一致。

Parameters

stringrequired

Domain name to check.

string

DNS record type to check (A, AAAA, CNAME, MX, TXT, etc.).

Code examples

curl -X POST https://api.botoi.com/v1/dns/propagation \
  -H "Content-Type: application/json" \
  -d '{"domain":"botoi.com","type":"A"}'

When to use this API

迁移后确认 DNS 更改

将网站迁移到新的托管提供商后，检查更新的 A 记录是否已在 Google、Cloudflare 和 Quad9 之间传播。 等到一致标志为真后再切换流量或更新监控工具。

调试特定于区域的 DNS 故障

当某些区域的用户报告他们无法访问您的站点时，请检查传播以查看特定解析程序是否返回过时或不正确的记录。 这将问题范围缩小到特定解析器的缓存问题与注册商的配置错误。

在 CI/CD 中自动验证 DNS 更改

Terraform 或 Pulumi 部署更新 DNS 记录后，添加轮询此端点的管道步骤。 如果 5 分钟内所有解析器的记录不一致，则管道失败。

Frequently asked questions

检查哪些 DNS 解析器？
Google (8.8.8.8)、Cloudflare (1.1.1.1) 和 Quad9 (9.9.9.9)。 它们代表了三个最广泛使用的公共 DNS 解析器。
一致场是什么意思？
当所有三个解析器返回相同的记录集时，confirm 为 true。 如果任何解析器返回不同的值，则一致性为 false。
DNS 传播需要多长时间？
这取决于旧记录的 TTL。 大多数更改会在 5 分钟到 48 小时内传播。 短 TTL（300 秒）比长 TTL（86400 秒）传播得更快。
我可以检查 MX 或 TXT 记录的传播吗？
是的。 将类型参数设置为 MX、TXT、CNAME、AAAA 或任何支持的记录类型。 如果省略则默认为 A。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs