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。