更新域名验证方式

PUT

/openapi/v3/domains/:id/dcv-method

更新指定预审核域名的验证方式，并返回当前域名验证信息。

路径参数

参数	类型	必填	说明
id	string	是	预审核域名 ID

Body 参数 application/json

参数	类型	必填	说明
dcv_method	string	是	域名验证方式：dns、file、cname、email、dns-persist
email	string	条件	当 dcv_method 为 email 时必传，传 WHOIS 邮箱或域名管理员邮箱
persist_until	int64	否	仅当 dcv_method=dns-persist 时生效。未传不覆盖原值；0 表示永久有效；>0 覆盖为指定时间（UNIX 秒）
persist_policy	string	否	仅当 dcv_method=dns-persist 时生效。授权范围：fqdn（默认）或 wildcard
user_external_id	string	否	终端用户标识，格式为 1–32 个字母、数字、_ 或 -；使用 dns-persist 场景建议传递

返回参数

参数	类型	说明
id	string	域名 ID
domain	string	域名
dcv_method	string	域名验证方式
email	string	域名验证邮箱
auth_path	string	验证记录名或文件路径，随验证方式而定
auth_val	string	域名验证值
real_val	string	真实验证值（部分场景下返回实际需要配置的验证值）

请求示例

curl -X PUT 'https://api.certcloud.cn/openapi/v3/domains/8tnsIUXQ/dcv-method' \
  -H 'Content-Type: application/json' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -d '{
    "dcv_method": "file"
  }'

const response = await fetch('https://api.certcloud.cn/openapi/v3/domains/8tnsIUXQ/dcv-method', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  },
  body: JSON.stringify({
    dcv_method: 'file'
  })
})
const data = await response.json()

body := map[string]interface{}{
  "dcv_method": "file",
}
jsonBody, _ := json.Marshal(body)
req, _ := http.NewRequest("PUT", "https://api.certcloud.cn/openapi/v3/domains/8tnsIUXQ/dcv-method", bytes.NewBuffer(jsonBody))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
resp, err := http.DefaultClient.Do(req)

import requests

response = requests.put(
    'https://api.certcloud.cn/openapi/v3/domains/8tnsIUXQ/dcv-method',
    headers={
        'Content-Type': 'application/json',
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    },
    json={
        'dcv_method': 'file'
    }
)
data = response.json()

响应示例

200成功

{
  "data": {
    "id": "8tnsIUXQ",
    "domain": "example.com",
    "dcv_method": "file",
    "auth_path": "/.well-known/pki-validation/fileauth.txt",
    "auth_val": "202310252228071f7o0cy2b6bkpu4693lefpc8fj4zqyglhpzy7i8ql656p08gbc"
  },
  "code": "success"
}

相关文档

• 创建预审核域名
• 刷新域名验证值
• 域名验证完成
• 开发前必读 §4 域名审核