1ms.tools
API

RDAP 查询 API

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

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

适合怎样的系统接入

适合域名资产资料同步、状态检查和结构化注册信息报表。接口使用 IANA 引导数据选择 RDAP 服务，返回字段与原始 JSON，便于按来源核验。

请求示例

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

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

请求接受后返回 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'

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

API 接入常见问题

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

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

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

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