| 接口名称 | 变更域名验证方式 |
| URL | [ POST ] /api/ssl/v3/dcv/{uuid}/change_dcv_method |
| 功能 | 用于申请中的证书变更域名验证方式，sectigo 支持：email,http,https,dns ， digicert/geotrust/rapidssl 支持 ：email,http,dns |
Path参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| uuid | string | 必需 | uuid 证书的uuid编号 |
Query参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| _format | string | 必需 | 接口数据格式 目前支持 json |
Body参数
Content-Type: application/json| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| dcv_method | string | 必需 | 域名验证方式 sectigo ：email,http,https,dns digicert/geotrust/rapidssl/thawte ：email,http,dns |
| approver_email | string | 可选 | 参数 common_name 的验证邮箱 当 dcv_method 为 email 时需要提供，common_name 的验证邮箱，CA将发送验证邮件到该邮箱，如未提供，默认发送到 admin@ 邮箱 |
| dns_names | string | 可选 | 附加域名 仅多域名证书需要提供，多个域名之间用英文逗号隔开 |
| approver_emails | string | 可选 | 附加域名的验证邮箱 当 dcv_method 为 email 时需要提供，dns_names 的验证邮箱，CA将发送验证邮件到该邮箱，如未提供，默认发送到 admin@ 邮箱，多个邮箱之间用英文逗号隔开，请按dns_names 的顺序排列每个域名对应的邮箱 |
请求示例 : 把 域名验证方式 改成 文件验证
{
"dcv_method": "http"
}
请求示例 : 把 域名验证方式 改成 dns 验证
{
"dcv_method": "dns"
}
请求示例 : 把 域名验证方式 改成 EMAIL验证
{
"dcv_method": "email",
"approver_email": "admin@domain.com",
"dns_names": "domain1.com,domain2.com,domain3.com",
"approver_emails": "admin@domain1.com,admin@domain2.com,admin@domain3.com"
}
返回值
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| code | integer | 必需 | 状态码 成功将返回 200 |
| message | string | 必需 | 状态描述 如请求出错，显示具体错误信息 |
| data | object | 可选 | |
| data . dcvList | array | 可选 | 域名验证信息 |
| data . dcvList . [] . domainName | string | 可选 | 域名 |
| data . dcvList . [] . dcvMethod | string | 可选 | 验证方式 sectigo ：email,http,https,dns digicert/geotrust/rapidssl/thawte ：email,http,dns |
| data . dcvList . [] . dcvEmail | string | 可选 | 采用DNS验证时，CA发送验证邮件到该邮箱 |
| data . dcvList . [] . dcvStatus | string | 可选 | 域名验证状态 |
| data . dcvList . [] . value | string | 可选 | 验证值 |
| data . dcvList . [] . validationDomain | string | 可选 | 采用DNS验证时，CA检测的域名 |
| data . dcvList . [] . prefix | string | 可选 | 采用DNS验证时的主机名 |
| data . dcvList . [] . dnsType | string | 可选 | 采用DNS验证时的DNS记录类型 |
| data . dcvList . [] . dnsValue | string | 可选 | 采用DNS验证时的记录值 |
| data . dcvList . [] . filename | string | 可选 | 采用文件验证时的文件名 |
| data . dcvList . [] . content | string | 可选 | 采用文件验证时的文件内容 |
| data . dcvList . [] . path | string | 可选 | 采用文件验证时的验证网址 |
返回示例
{
"code": 200,
"message": "Command completed successfully",
"data": {
"dcvList": [
{
"domainName": "test.domain.com",
"dcvMethod": "dns",
"dcvEmail": "",
"dcvStatus": "notCompleted",
"value": "",
"validationDomain": "_ad76a9ae743a50626de4065fcd5d1f81.domain.com",
"prefix": "_ad76a9ae743a50626de4065fcd5d1f81",
"dnsType": "CNAME",
"dnsValue": "7c457b0ccb0df56607ab8ca2fbe8fb77.d5459f94cf2226e79727d91d0ad52525.sectigo.com",
"filename": "",
"content": "",
"path": ""
}
]
}
}
