Domain name for API request: ssl.intl.tencentcloudapi.com.
Submit a certificate order
A maximum of 10 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: CertificateOrderSubmit. |
| Version | Yes | String | Common Params. The value used for this API: 2019-12-05. |
| Region | No | String | Common Params. This parameter is not required for this API. |
| CertId | Yes | String | Paid SSL certificate ID of materials to be submitted. |
| DeleteDnsAutoRecord | No | Integer | Whether to delete automatic DNS validation: 0, do not delete; 1, delete; default is do not delete. |
| VerifyType | No | String | Domain validation method of the certificate DNS: Manually add domain DNS validation. The user needs to manually add the verification value at the DNS service provider. FILE: Manual domain addition via FILE verification. Users are advised to manually add the specified path FILE to the root directory of the domain site for FILE verification. Either http or https access is sufficient. The domain site must be accessible by overseas certificate authorities. For the specific access allowlist, refer to the console page. |
| Parameter Name | Type | Description |
|---|---|---|
| OrderId | String | Order number from the certificate authority. |
| Status | Integer | Certificate status. 0=Under review, 1=Approved, 2=Review failed, 3=Expired, 4=DNS record added, 5=Enterprise certificate, pending submission, 6=Order cancellation in progress, 7=Canceled, 8=Documents submitted, pending upload of confirmation letter, 9=Certificate revocation in progress, 10=Revoked, 11=Reissue in progress, 12=Pending upload of revocation confirmation letter, 13=Free certificate pending document submission. |
| IsAudited | Boolean | Whether prereview is required or not |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
Submit order for paid SSL certificate
POST / HTTP/1.1
Host: ssl.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CertificateOrderSubmit
<Common request parameters>
{
"CertId": "Dsqef134",
"DeleteDnsAutoRecord": 1,
"VerifyType": "DNS"
}
{
"Response": {
"OrderId": "SO8zRv29",
"Status": 8,
"IsAudited": true,
"RequestId": "9b397ac6-7d01-4fbc-8acc-52dd6ff0877b"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| FailedOperation | Operation failed. |
| FailedOperation.AuthError | You do not have permission to perform this operation. |
| FailedOperation.CertificateInfoSubmitStatusInvalid | Certificate status does not allow submitting documentation. |
| FailedOperation.CertificateInvalid | The certificate is invalid. |
| FailedOperation.CertificateNotFound | The certificate does not exist. |
| FailedOperation.CertificateOrderSubmitProcessing | Your order is being processed. Please wait patiently. |
| FailedOperation.CertificatePreVerifyEmailInvalid | The format of the entered email address is incorrect. Please check and resubmit. |
| FailedOperation.InvalidCertificateStatusCode | The certificate status is incorrect. |
| FailedOperation.InvalidParam | Incorrect parameters. |
| FailedOperation.NetworkError | The CA system is busy. Try again later. |
| FailedOperation.NoProjectPermission | You do not have the permission to operate on this project. |
| FailedOperation.NoRealNameAuth | You have not completed the identity verification. |
| InternalError | Internal error. |
| InternalError.BackendResponseError | An error occurred with the backend service response. |
Was this page helpful?
You can also Contact sales or Submit a Ticket for help.
Help us improve! Rate your documentation experience in 5 mins.
Feedback