This is a series of articles dedicated to demonstrating how to get acquainted with Openprovider SSL API methods. If you want to go the beginning of this guide, please navigate to the article "1 How to choose a product".
To get more information about our API in general, please use our documentation portal as your reference.
Renewal is a process of extending a certificate expiration date. It is available for the certificates in status ACT and can be requested within the 30 days before expiration date.
The price for the renew is the same as for the create operation (prices are already retrieved by us before).
Renewal vice versa reissue does not change any certificate data except the expiration date.
It will be extended to the same period we selected while used order creation.
You can't change any certificate data during the renew process. So if you need it - you can just request
a new certificate.
Our advice is to start the new order at least 4 weeks before the current SSL certificate expires to prevent any interruption of your secured website. If you start the order within the last 30 days of the old SSL being active, the remaining period of the SSL certificate will be added to the new certificate (only within the current active order). That means that if you have expiration date of the 1 year certificate 01.05.2019 and requested renew at 01.04.2019 the expiration date of the renewed certificate will still be 01.05.2020.
Please note renewal is applicable for certificates that are active and not yet expired.
POST {base_url}/ssl/orders/{id}/renew
REQUEST VALUES↓
Name |
Type |
Values |
Description |
---|---|---|---|
id | integer | numeric value |
REQUEST EXAMPLE↓
curl -X POST \
https://api.cte.openprovider.eu/v1beta/ssl/orders/1/renew \
-H 'Authorization: Bearer deb4bf804928981b018caf45c3c4142b' \
-H 'Content-Type: application/json' \
-d '{
"id":"1"
}'
RESPONSE EXAMPLE↓
{
"code": 0,
"data": {
"id": 1
},
"desc": ""
}
RESPONSE VALUES↓
Name |
Values |
Description |
---|---|---|
code |
result code number |
API Result with code returned. |
1. data |
set of values | Renew Order Response Data. |
1.1 id |
integer | Returns Openprovider order ID that been processed. |
desc |
string | Description text value (if available). |
maintenance |
True or false. | Indicates if system maintenance is in progress now. |
2. warnings |
An array of numeric value and string(s) | An array of warning messages. |
2.1 code |
numeric code returned | Warning numeric code returned (if available). |
2.2 data |
string | Additional warning description. |
2.3 desc |
string | Warning description. |
We checked how we can easily renew our certificate.
What if you sell too much SSL for end-users and want to share an order with your customer?
No problem cause we offer a dedicated method for this also: "11 Open an access to an end user".