刷新域名验证值

PUT

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

刷新指定预审核域名的域名验证值（DCV 值），返回更新后的域名验证信息，包括验证方式、验证路径、验证值等。

路径参数

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

Body 参数 application/json

参数	类型	必填	说明
persist_until	int64	否	仅 dns-persist 场景生效。未传不覆盖原值；0 表示永久有效；>0 覆盖为指定时间（UNIX 秒）
persist_policy	string	否	仅 dns-persist 场景生效。授权范围：fqdn（默认）或 wildcard
user_external_id	string	否	终端用户标识，格式为 1–32 个字母、数字、_ 或 -

返回参数

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

请求示例

curl -X PUT 'https://api.certcloud.cn/openapi/v3/domains/DOM123456/dcv-val' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id'

const response = await fetch('https://api.certcloud.cn/openapi/v3/domains/DOM123456/dcv-val', {
  method: 'PUT',
  headers: {
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  }
})
const data = await response.json()

req, _ := http.NewRequest("PUT", "https://api.certcloud.cn/openapi/v3/domains/DOM123456/dcv-val", nil)
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/DOM123456/dcv-val',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    }
)
data = response.json()

响应示例

以 HTTP 文件验证方式为例：

200成功

{
  "code": "success",
  "data": {
    "id": "DOM123456",
    "domain": "example.com",
    "dcv_method": "file",
    "auth_path": "/.well-known/pki-validation/fileauth.txt",
    "auth_val": "202402101234567890abcdef1234567890abcdef1234567890"
  }
}

相关文档

• 更新域名验证方式
• 域名验证完成
• 域名续期
• 开发前必读 §4 域名审核