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

DNS Lookup API - 免费 DNS 记录查询

使用 Cloudflare DNS-over-HTTPS 查询域的 DNS 记录。 支持 A、AAAA、MX、TXT、CNAME、NS、SOA 和 PTR 记录类型。

Parameters

stringrequired

Domain name to look up.

string

DNS record type to query.

Code examples

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

When to use this API

在加入期间验证域配置

当客户将自定义域添加到您的 SaaS 平台时,查询其 CNAME 或 A 记录以确认 DNS 指向您的服务器。 一旦记录符合您的预期值,就会显示绿色复选标记。

监控 MX 记录更改以确保电子邮件送达率

为您的发送域安排定期 MX 查找以检测意外更改。 如果 MX 记录被删除或更改,请向您的运营团队发出警报,这可能表明 DNS 劫持或配置错误影响了电子邮件传送。

审核 TXT 记录以确保 SPF 和 DKIM 合规性

查询域的 TXT 记录以提取 SPF 和 DKIM 条目。 解析这些值以验证它们是否符合您的预期配置,并标记缺少或过于宽松的策略的域。

Frequently asked questions

该端点使用哪个 DNS 解析器?
查询通过 Cloudflare DNS-over-HTTPS (1.1.1.1)。 这提供了快速、尊重隐私的解决方案,而无需缓存陈旧的记录。
支持哪些记录类型?
A、AAAA、CNAME、MX、NS、TXT、SOA、SRV、CAA 和 PTR。 指定类型参数; 如果省略则默认为 A。
我可以查找子域吗?
是的。 将完整的子域(例如“api.github.com”)作为域参数传递。 端点解析您提供的任何域字符串。
query_time_ms代表什么?
query_time_ms 是 DNS 解析在服务器端花费的时间(以毫秒为单位)。 它不包括从客户端到 API 的网络往返时间。
这是否返回所请求类型的所有记录?
是的。 如果一个域有多个 A 记录或多个 MX 记录,则所有这些记录都将及其各自的 TTL 值返回到记录数组中。

Get your API key

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