1ms.tools
APIMCPSkills定价
REST · OpenAPI 3.1

WHOIS Lookup API

通过 API 查询域名 WHOIS，发现权威服务并返回原始注册记录，便于在应用中展示注册信息和排查域名状态。

  • WHOIS 数据可能被隐私保护、注册局规则或查询限制遮蔽；不能保证返回所有联系人和日期字段。
  • 成功任务 1 积分 / 次
  • 对外调用 10 次 / 分钟 / 账号
获取 API Key在线使用 API
响应结果预览

example.com

什么是 WHOIS Lookup API？

通过 API 查询域名 WHOIS，发现权威服务并返回原始注册记录，便于在应用中展示注册信息和排查域名状态。

应用场景

  • 域名资产归档

    为域名资产台账归档公开注册信息，保留查询时间与来源。

  • 注册信息变化跟踪

    定期对比注册信息，发现注册商、状态或域名服务器等可见变化。

  • 域名客服排查

    客服处理域名问题时，提供原始注册记录作为排查依据。

Playground

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

输入
正在加载…

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

域名或查询目标。

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

接口参考

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

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

JSON 请求参数

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

data.result 结果字段

字段类型检测到的网页描述，可能为 null。
domainstring域名或查询目标。
whois_serverstring返回结果的 43 端口 WHOIS 服务器。
rawstring原始 RDAP JSON 对象。

响应示例

接口结构示例，非实时查询或注册局实测记录。
{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "JOB_ID",
    "status": "succeeded",
    "result": {
      "domain": "example.com",
      "whois_server": "whois.example.net",
      "raw": "Domain Name: EXAMPLE.COM\n"
    },
    "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'

WHOIS 数据可能被隐私保护、注册局规则或查询限制遮蔽；不能保证返回所有联系人和日期字段。

需要处理的错误

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

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

API 接入常见问题

通过 API 查询域名 WHOIS，发现权威服务并返回原始注册记录，便于在应用中展示注册信息和排查域名状态。

WHOIS 数据可能被隐私保护、注册局规则或查询限制遮蔽；不能保证返回所有联系人和日期字段。

可以。使用 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。