1ms.tools
APIMCPSkills定价
REST · OpenAPI 3.1

DNS Lookup API

按域名和记录类型查询 DNS，获取结构化的解析记录、域名服务器和查询错误，方便接入域名配置检查。

  • 结果包含查询到的记录和错误信息。缓存及 DNS 传播可能造成短时差异，检测结果不能替代对注册商或 DNS 平台的配置确认。
  • 成功任务 1 积分 / 次
  • 对外调用 10 次 / 分钟 / 账号
获取 API Key在线使用 API
响应结果预览

example.com

什么是 DNS Lookup API？

按域名和记录类型查询 DNS，获取结构化的解析记录、域名服务器和查询错误，方便接入域名配置检查。

应用场景

  • 自定义域名接入

    客户绑定自定义域名时，核对 DNS 记录是否与要求一致。

  • 域名与邮件迁移

    域名迁移或邮件服务切换后，检查相关记录是否已更新。

  • 解析故障排查

    网站或邮件出现访问问题时，按记录类型排查域名解析错误。

Playground

发送真实 API 请求，查看任务状态和返回结果。

输入
正在加载…

填写下面的字段即可开始。只有需要直接编辑请求内容时才切换到 JSON。

域名或查询目标。

类型

输出
运行 API 后在这里查看结果。

接口参考

将示例密钥替换为控制台创建的密钥。输入仅作为接入示例，完整字段和校验规则见 API 文档。 API 文档

请求示例
POST /openapi/v1/tools/1ms/dns/execute
curl 'https://1ms.tools/openapi/v1/tools/1ms/dns/execute' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  -d '{"domain":"example.com","type":"all"}'

JSON 请求参数

字段类型必填检测到的网页描述，可能为 null。
domainstring必填域名或查询目标。
typestring必填类型

data.result 结果字段

字段类型检测到的网页描述，可能为 null。
domainstring域名或查询目标。
statusstring供应商或协议状态。
resolverstringDNS 响应使用的解析器或数据源。
recordsarray包含类型、所有者名称、TTL 和值的标准化 DNS 记录。

响应示例

接口结构示例，非实时查询或注册局实测记录。
{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "JOB_ID",
    "status": "succeeded",
    "result": {
      "domain": "example.com",
      "status": "NOERROR",
      "resolver": "1ms",
      "records": [
        {
          "type": "A",
          "name": "example.com.",
          "ttl": null,
          "value": "192.0.2.1"
        }
      ]
    },
    "error": null,
    "creditCost": 1,
    "creditsRefunded": false,
    "pollAfterMs": 6000,
    "statusUrl": "/openapi/v1/jobs/JOB_ID"
  }
}
异步响应与结果获取
至少等待 6 秒后使用同一密钥查询。状态为 succeeded 时读取 result；failed 或 canceled 时读取 error。
curl 'https://1ms.tools/openapi/v1/jobs/JOB_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

结果包含查询到的记录和错误信息。缓存及 DNS 传播可能造成短时差异，检测结果不能替代对注册商或 DNS 平台的配置确认。

需要处理的错误

执行错误通过失败任务的 data.error 返回。状态查询成功仍可返回 HTTP 200。

400参数不合法，不创建任务、不预扣积分。
401缺少密钥，密钥无效、撤销或过期。
402账号积分不足，不创建任务。
404资源不存在，或不属于当前账号。
409幂等键与参数冲突，或任务不能取消。
429账号调用额度达到上限，等待 Retry-After。
500提交异常，使用原幂等键重试确认。
在智能体中使用DNS Lookup API
通过共用的 1ms.tools MCP 服务或 Agent Skill 调用 execute_1ms/dns。共用 API Key 与计费标准，成功任务每次 1 积分。
MCP server Agent Skill

API 接入常见问题

按域名和记录类型查询 DNS，获取结构化的解析记录、域名服务器和查询错误，方便接入域名配置检查。

结果包含查询到的记录和错误信息。缓存及 DNS 传播可能造成短时差异，检测结果不能替代对注册商或 DNS 平台的配置确认。

可以。使用 API Key 或浏览器 OAuth 授权连接 MCP 服务，或安装可下载的 Agent Skill。这些入口均使用异步任务，共用账号积分与限流。

使用 Authorization: Bearer YOUR_API_KEY 或 X-API-Key 请求头。对外接口必须提供有效密钥，网页 Cookie 无法替代。请将密钥保存在服务器或可信应用环境中。

创建任务时预扣 1 积分，任务成功后完成计费。输入校验失败或积分不足时不创建任务、不扣积分。任务查询不扣积分，但计入调用次数。

任务执行失败、在服务端超时或排队时取消，预扣积分会自动全额退回账户，无需申请；成功完成的任务正常计费。仅排队中的任务可取消，关闭页面或客户端请求超时不代表任务已取消或失败。以任务最终状态和 creditsRefunded 字段为准，退回记录可在积分明细查看。

本接口使用异步任务，先返回 HTTP 202 和 Job ID。通过返回的 statusUrl 获取状态，成功后读取 result。建议使用 Idempotency-Key 处理提交重试。

每个账号每自然分钟最多 10 次对外业务请求，所有 Key 共用额度，与网页请求计数分开。任务查询、上传和执行都计入额度；遇到 429 时遵守 Retry-After。