创建预审核域名

POST

/openapi/v3/domains

创建预审核的域名记录。预审核的域名必须创建在对应的组织下，需要先创建组织才能创建域名。

Body 参数 application/json

参数	类型	必填	说明
domain	string	是	域名
sub_domain	bool	否	是否创建子域名。当 domain 为子域名时，默认会创建该子域名所属主域名的预审核；为 true 时才会创建对应子域名的预审核
dcv_method	string	是	域名验证方式：dns、file、cname、email、dns-persist
email	string	条件	当 dcv_method 为 email 时必传，传 WHOIS 邮箱或域名管理员邮箱
org_id	string	是	组织 ID
persist_until	int64	否	仅当 dcv_method=dns-persist 时生效。验证值有效期（UNIX 秒）；0 表示永久有效
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 POST 'https://api.certcloud.cn/openapi/v3/domains' \
  -H 'Content-Type: application/json' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -d '{
    "domain": "example.com",
    "sub_domain": false,
    "dcv_method": "dns",
    "org_id": "yAvsAzQ6"
  }'

const response = await fetch('https://api.certcloud.cn/openapi/v3/domains', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  },
  body: JSON.stringify({
    domain: 'example.com',
    sub_domain: false,
    dcv_method: 'dns',
    org_id: 'yAvsAzQ6'
  })
})
const data = await response.json()

body := map[string]interface{}{
  "domain":     "example.com",
  "sub_domain": false,
  "dcv_method": "dns",
  "org_id":     "yAvsAzQ6",
}
jsonBody, _ := json.Marshal(body)
req, _ := http.NewRequest("POST", "https://api.certcloud.cn/openapi/v3/domains", 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.post(
    'https://api.certcloud.cn/openapi/v3/domains',
    headers={
        'Content-Type': 'application/json',
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    },
    json={
        'domain': 'example.com',
        'sub_domain': False,
        'dcv_method': 'dns',
        'org_id': 'yAvsAzQ6'
    }
)
data = response.json()

响应示例

200成功

{
  "data": {
    "id": "8tnsIUXQ",
    "domain": "example.com",
    "dcv_method": "dns",
    "email": ""
  },
  "code": "success"
}

相关文档

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