2.12 替换SSL订阅信息
2.12.1 Api信息
| 测试环境 | |
|---|---|
| 真实环境 | https://portal.racent.com/ssl/replace |
| 请求方式 | POST |
| content-type | multipart/form-data |
| 描述 | 此接口用于替换SSL订阅信息。仅与SSL证书相关。只有当SSL订阅状态为已签发，才允许替换SSL订阅信息。 |
2.12.2 参数定义
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| api_token | String | Y | 身份凭据，生成token请联系锐成技术支持。 |
| certId | String | Y | racent证书id |
| refId | String | N | 客户提供的唯一客户订单号 |
| domainVerificationPic | File | N | 当域名验证方式为：VERIFY_DOCUMENT，此项为Y。用于域名所有权验证（目前仅支持CFCA）。 |
| params | String | Y | 替换信息，具体描述如下 |
| csr | String | Y | 注：CSR信息中的域名必须与原SSL订阅中CSR中的域名保持一致。 |
| uniqueValue | String | N | 仅与Sectigo产品相关。1-20个字符（a-z A-Z 0-9）用于分销商自主生成验证值。。 |
| dcvMethod | String | N | 统一设置申请域名验证方式。 必须为以下四种方式之一： EMAIL(邮箱验证) HTTP_CSR_HASH(文件验证) CNAME_CSR_HASH(DNS验证) HTTPS_CSR_HASH(https文件验证) VERIFY_DOCUMENT(域名证书证明,仅支持CFCA) CFCA该项为Y |
| domainInfo | String | Y | 域名信息。 示例： [ { "dcvEmail": "admin@xxx.com", "dcvMethod": "EMAIL", "domainName": "www.xxx.com" }, { "dcvEmail": "admin@aaa.com", "dcvMethod": "EMAIL", "domainName": "aaa.com" }, "dcvEmail": "admin@racent.com", "dcvMethod": "EMAIL", "domainName": "racent.com" } ] 具体描述如下： |
| dcvMethod | String | Y | 域名验证方式。 必须为以下四种方式之一： EMAIL(邮箱验证) HTTP_CSR_HASH(文件验证) CNAME_CSR_HASH(DNS验证) HTTPS_CSR_HASH(https文件验证) 当上级dcvMethod不存在时，此项为Y。 当上级dcvMethod存在，该项也存在，会优先使用上级dcvMethod。 |
| dcvEmail | String | N | 域名验证邮箱。 该项为N时，缺省情况如下 racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com |
| domainName | String | Y | 域名 |
| organizationInfo | String | N | 当你需要更改公司信息，此参数为Y。 |
| organizationCity | String | N | 公司所在城市。 |
| organizationName | String | N | 公司名称。 |
| organizationMobile | String | N | 公司电话。 |
| organizationAddress | String | N | 公司地址。 |
| organizationCountry | String | N | 公司所在国家( ISO 3166-1标准中的 双字母代码)。 |
| organizationPostCode | String | N | 公司所在地邮编。 |
函数返回
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| code | Int | Y | 返回状态，具体详解请参见附录3.1 |
| errors | Object or String | N | 当返回状态为错误时，具体错误信息。 |
| data | Object | N | 当返回状态为成功时，此参数为Y。具体描述如下： |
| certId | String | N | racent证书id。请妥善保管，此参数为racent实例唯一凭据。 |
| vendorId | String | N | CA订单号。 |
| vendorCertId | String | N | CA证书号。 |
| DCVfileName | String | N | 文件验证文件名 |
| DCVfileContent | String | N | 文件验证文件内容 |
| DCVdnsHost | String | N | Dns验证主机值 |
| DCVdnsValue | String | N | Dns验证记录值 |
| DCVdnsType | String | N | Dns验证记录类型 |
| DCVfilePath | String | N | 文件验证文件路径 |
| dcvInfo | Object | N | 申请证书中的每个域名验证值不一样时，此项为Y 每项类型为Object，每项对象名为申请得域名，如:racent.com。每项详情如下： |
| DCVfileName | String | N | 文件验证文件内容 |
| DCVfileContent | String | N | 文件验证文件内容 |
| DCVdnsHost | String | N | Dns验证主机值 |
| DCVdnsValue | String | N | Dns验证记录值 |
| DCVdnsType | String | N | Dns验证记录类型 |
| DCVfilePath | String | N | 文件验证文件路径 |