1ms.tools
API

Domain Connect 验证 API

提交 Domain Connect 服务配置、参数和签名材料，校验流程并生成用于域名配置的签名应用链接。

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

适合怎样的系统接入

适合已经配置 Domain Connect 服务的应用接入。调用方需要提供自己的服务标识、参数和签名材料；请只在可信服务器环境中处理私钥。

请求示例

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

POST /openapi/tools/domain-connect-link/execute
curl 'https://1ms.tools/openapi/tools/domain-connect-link/execute' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  -d '{"domain":"example.com","host":"@","providerId":"provider","serviceId":"website","syncUxUrl":"https://provider.example.com","keyName":"my-key","privateKey":"YOUR_PRIVATE_KEY_PEM","redirectUri":"https://example.com","params":[{"key":"ip","value":"192.0.2.1"}]}'
异步响应与结果获取

请求接受后返回 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 已修改；用户仍需在支持的服务商流程中完成授权与应用。此接口当前为 Beta。

API 接入常见问题

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

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

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

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