2.13 Modify the Domain Control Validation Method for SSL Subscriptions
2.13.1 API Information
| Test Environment | |
|---|---|
| Production environment | https://portal.racent.com/ssl/updateDCV |
| Request method | POST |
| content-type | multipart/form-data |
| Description | This API is used to modify the domain validation method for an SSL subscription. This operation is only allowed when the SSL subscription status is "Applying". |
2.13.2 Parameter Definition
| Parameter name | Parameter type | Required | Description |
|---|---|---|---|
| api_token | String | Y | Identity credential. Please contact Racent technical support to generate a token. |
| certId | String | Y | Racent certificate ID |
| domainName | String | N | Domain name. This parameter is required (Y) when the certificate is a multi-domain certificate. |
| dcvMethod | String | Y | Domain validation method. See section 2.2 for allowed values. |
| dcvEmail | String | Y | Domain validation email address. This parameter is required (Y) when dcvMethod is set to EMAIL. |
Function Return
| Parameter name | Parameter type | Required | Description |
|---|---|---|---|
| code | Int | Y | Return status. See Appendix 3.1 for detailed explanations. |
| errors | Object or String | N | Specific error information when the return status indicates an error. |
| data | Object | N | This parameter is required (Y) when the return status indicates success. Details are described as follows: |
| DCVfileName | String | N | File validation file name |
| DCVfileContent | String | N | File validation file content |
| DCVdnsHost | String | N | DNS validation host value |
| DCVdnsValue | String | N | DNS validation record value |
| DCVdnsType | String | N | DNS validation record type |
| DCVfilePath | String | N | File validation file path |
| dcvInfo | Object | N | This value is Y when the validation value is different for each domain name in the certificate request Each entry is of Object type, with the object name set to the requested domain name, e.g. racent.com. Details for each entry are as follows: |
| DCVfileName | String | N | File validation file name |
| DCVfileContent | String | N | File validation file content |
| DCVdnsHost | String | N | DNS validation host value |
| DCVdnsValue | String | N | DNS validation record value |
| DCVdnsType | String | N | DNS validation record type |
| DCVfilePath | String | N | File validation file path |