修改域名验证方式

PUT

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

切换订单中域名的验证方式。如果是多域名订单，这里将进行整体切换。

对于支持域名预审核的产品，已通过预审核的域名（包括多域名订单中已通过的域名）不会切换，仍保留原验证方式。

邮件验证的收件地址由系统按域名管理员邮箱规则处理，不通过本接口指定。

路径参数

参数	类型	必填	说明
id	string	是	订单 ID

Body 参数

参数	类型	必填	说明
dcv_method	string	是	域名验证方式，参考域名验证方式
persist_until	int64	按需	仅当 dcv_method=dns-persist 时生效。未传不覆盖原值，0 表示永久有效，>0 覆盖为指定时间
persist_policy	string	按需	仅当 dcv_method=dns-persist 时生效。授权范围：fqdn（默认）或 wildcard
user_external_id	string	条件	终端用户标识，格式为 1–32 个字母、数字、_ 或 -。使用 dns-persist 时，多租户（渠道）客户必须传入；直客无需传入

返回数据

参数	类型	说明
dcv_vals	array[object]	域名验证结果列表
∟ id	string	验证域名 ID
∟ domain	string	验证域名
∟ dcv_method	string	域名验证方式
∟ auth_path	string	验证记录名或文件路径，随验证方式而定
∟ auth_val	string	验证值
∟ real_val	string	实际验证值（如适用）
∟ verified	bool	是否已通过本系统预检测；不代表 CA 最终验证结果，CAA、多视角等因素可能导致差异

请求示例

curl -X PUT 'https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/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/orders/TIT6R0qv/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'
  })
})

req, _ := http.NewRequest("PUT", "https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/dcv-method", strings.NewReader(`{
  "dcv_method": "file"
}`))
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, _ := http.DefaultClient.Do(req)

import requests

resp = requests.put(
    'https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/dcv-method',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    },
    json={
        'dcv_method': 'file'
    }
)

响应示例

示例 1：切换文件验证

200成功

{
  "data": {
    "dcv_vals": [
      {
        "domain": "test.isw.app",
        "auth_path": "/.well-known/pki-validation/A0F2293FBE713C1A941EE22255FD895B.txt",
        "auth_val": "F27048E2E9009858545CF4D67C66F10FCD4CC13639F997A2F7D87EDD549F3581\ntrust-provider.com\nCertClouddtc8xlb97h6",
        "verified": false,
        "dcv_method": "file"
      }
    ]
  },
  "code": "success"
}

示例 2：切换 DNS 长效验证

请求体：

{
  "dcv_method": "dns-persist",
  "persist_until": 0,
  "persist_policy": "fqdn",
  "user_external_id": "tenant_user_001"
}

200成功

{
  "data": {
    "dcv_vals": [
      {
        "domain": "test.isw.app",
        "auth_path": "_validation-persist",
        "auth_val": "trustasia.com; accounturi=https://dcv.trustasia.com/acct/tenant_user_001; policy=fqdn",
        "verified": false,
        "dcv_method": "dns-persist"
      }
    ]
  },
  "code": "success"
}