1ms.tools
APIMCPSkills定价
REST · OpenAPI 3.1

RDAP Lookup API

查询权威 RDAP 服务，获取结构化的域名注册信息、状态、事件和域名服务器，适合直接接入注册信息展示。

  • 不同注册局公开的 RDAP 字段可能不同。到期事件与注册商付款有效期也可能不同，请按实际来源解释数据。
  • 成功任务 1 积分 / 次
  • 对外调用 10 次 / 分钟 / 账号
获取 API Key在线使用 API
响应结果预览
暂无可视化结果，可切换到 JSON 查看完整响应。

什么是 RDAP Lookup API？

查询权威 RDAP 服务，获取结构化的域名注册信息、状态、事件和域名服务器，适合直接接入注册信息展示。

应用场景

  • 域名资产同步

    将公开注册信息同步到域名资产管理系统，减少人工整理。

  • 注册状态变更监测

    对比域名状态、注册事件和域名服务器，标记需要人工核查的变化。

  • 注册信息报告

    为客户或内部团队生成可追溯的域名注册信息报告。

Playground

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

输入
正在加载…

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

域名或查询目标。

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

接口参考

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

请求示例
POST /openapi/v1/tools/1ms/rdap/execute
curl 'https://1ms.tools/openapi/v1/tools/1ms/rdap/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。
objectClassNamestringRDAP 对象类型。
ldhNamestringASCII LDH 格式的域名。
statusarray供应商或协议状态。
eventsarrayRDAP 注册生命周期事件。

响应示例

接口结构示例，非实时查询或注册局实测记录。
{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "JOB_ID",
    "status": "succeeded",
    "result": {
      "objectClassName": "domain",
      "ldhName": "EXAMPLE.COM",
      "status": [],
      "events": []
    },
    "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'

不同注册局公开的 RDAP 字段可能不同。到期事件与注册商付款有效期也可能不同，请按实际来源解释数据。

需要处理的错误

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

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

API 接入常见问题

查询权威 RDAP 服务，获取结构化的域名注册信息、状态、事件和域名服务器，适合直接接入注册信息展示。

不同注册局公开的 RDAP 字段可能不同。到期事件与注册商付款有效期也可能不同，请按实际来源解释数据。

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