DNS 解析

Cloudflare / Google

DNS 与域名可直接调用免费

在线调试上游文档

调用地址

GET https://api.blueworkshop.top/api/v1/dns

无需鉴权支持 CORS 每 IP 每分钟 60 次；相同查询缓存 60 秒

在线调试

请求会发送到本站接口

当前请求：https://api.blueworkshop.top/api/v1/dns

请求参数

参数	类型	默认值	说明
`name`必填	string	-	要解析的域名，例如 example.com。支持国际化域名。示例：`example.com`
`type`	枚举：A / AAAA / CNAME / MX / TXT / NS / SOA / SRV / PTR / CAA	`A`	DNS 记录类型，默认 A。示例：`A`
`provider`	枚举：cloudflare / google	`cloudflare`	解析服务商：cloudflare（Cloudflare 1.1.1.1）或 google（Google Public DNS）。示例：`cloudflare`

请求示例

cURL

curl "https://api.blueworkshop.top/api/v1/dns?name=example.com&type=A&provider=cloudflare"

JavaScript

const res = await fetch("https://api.blueworkshop.top/api/v1/dns?name=example.com&type=A&provider=cloudflare");
const data = await res.json();
console.log(data);

响应示例

{
  "ok": true,
  "data": {
    "query": {
      "name": "example.com",
      "type": "A",
      "provider": "cloudflare"
    },
    "status": 0,
    "statusText": "NOERROR",
    "answers": [
      {
        "name": "example.com",
        "type": "A",
        "ttl": 259,
        "data": "104.20.23.154"
      },
      {
        "name": "example.com",
        "type": "A",
        "ttl": 259,
        "data": "172.66.147.243"
      }
    ],
    "authority": []
  },
  "meta": {
    "endpoint": "dns",
    "cached": false
  }
}

成功时返回 JSON 信封：ok 表示是否成功，data 为数据，meta.cached 表示是否命中本站缓存。图片类接口直接返回二进制图片。

错误响应

HTTP	错误码	说明
400	`missing_param` / `invalid_param`	缺少参数或参数格式不正确，响应会带上出错参数名。
404	`not_found`	接口不存在，或上游没有找到对应资源。
405	`method_not_allowed`	请求方法与接口要求不一致。
429	`rate_limited`	请求过于频繁，响应头 Retry-After 给出建议等待秒数。
502	`upstream_error` / `upstream_rate_limited`	上游服务异常或触发限流。
504	`timeout`	上游请求超时。

接口说明

无需申请密钥，直接请求本站即可完成域名解析。接口在服务端通过 DNS over HTTPS 向 Cloudflare 1.1.1.1 或 Google Public DNS 发起查询，并把结果整理为统一的 JSON 结构。

适合网站状态检查、域名排障、批量记录查询等场景。解析结果默认缓存 60 秒，同一查询不会重复访问上游。