域名续期

PUT

/openapi/v3/domains/:id/renew

当预审核域名处于 ca_auditing、expired 或 need_renew 状态时，可通过该接口触发域名续期并刷新验证值。

路径参数

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

返回参数

续期接口返回完整的域名对象：

参数	类型	说明
id	string	域名 ID
domain	string	域名
dcv_method	string	域名验证方式
auth_path	string	验证记录名或文件路径，随验证方式而定
auth_val	string	验证值（续期后刷新）
email	string	域名验证邮箱（email 验证方式返回）
real_val	string	真实验证值（部分场景下返回实际需要配置的验证值）
validations	array[object]	域名验证详情
created_time	string	创建时间
status	string	域名状态

请求示例

curl -X PUT 'https://api.certcloud.cn/openapi/v3/domains/8tnsIUXQ/renew' \
  -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/8tnsIUXQ/renew', {
  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/8tnsIUXQ/renew", 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/8tnsIUXQ/renew',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    }
)
data = response.json()

响应示例

200成功

{
  "code": "success",
  "data": {
    "id": "8tnsIUXQ",
    "domain": "example.com",
    "dcv_method": "file",
    "auth_path": "/.well-known/pki-validation/fileauth.txt",
    "auth_val": "202603201234567890abcdef",
    "created_time": "2026-03-20T12:00:00Z",
    "status": "ca_auditing"
  }
}

相关文档

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