1ms.tools
API

DNS 查询 API

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

成功任务 1 积分 / 次对外调用 10 次 / 分钟 / 账号
获取 API Key在线试用工具API 文档

适合怎样的系统接入

适合域名接入验证、DNS 配置巡检和客户域名管理。你的应用提交域名与记录类型，将返回结果和预期配置比较，再显示需要处理的差异。

请求示例

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

POST /openapi/tools/dns-lookup/execute
curl 'https://1ms.tools/openapi/tools/dns-lookup/execute' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  -d '{"domain":"example.com","types":["A","NS"]}'
异步响应与结果获取

请求接受后返回 HTTP 202 和任务信息。此时任务尚未完成，示例只列出常用字段。

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "JOB_ID",
    "status": "queued",
    "result": null,
    "creditCost": 1,
    "pollAfterMs": 6000,
    "statusUrl": "/openapi/jobs/JOB_ID"
  }
}

至少等待 6 秒后使用同一密钥查询。状态为 succeeded 时读取 result；failed 或 canceled 时读取 error。

curl 'https://1ms.tools/openapi/jobs/JOB_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

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

API 接入常见问题

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

创建任务时预扣 1 积分，任务成功后完成计费。输入校验失败或积分不足时不创建任务；执行失败、超时或取消排队任务会退款。任务查询不扣积分，但计入调用次数。

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

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