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.1 How to choose a product".
To get more information about our API in general, please use our documentation portal as your reference.
Using the previous method "2 Creating a CSR" we successfully generated a Certificate Signing Request (CSR) which is required to create an order for an SSL certificate.
There are three ways to confirm your domain ownership. They are email confirmation, DNS records placement and HTTP(s) file validation. If you want to request and confirm your order using email method you need to confirm certificate issuance by following link CA will provide you.
The approver-email method allows you to retrieve a list of the possible email addresses that could be used to give email confirmation of domain ownership.
Five email addresses are static (admin@..., administrator@..., postmaster@..., hostmaster@..., webmaster@...) and belong to the domain name you're protecting. Comodo products only accept one email address.
Described below is how to retrieve a list of available values of approver emails.
Please note if your WHOIS contains any public email addresses, they will also be included in the response and can be used to confirm domain ownership.
Five email addresses are static (admin@..., administrator@..., postmaster@..., hostmaster@..., webmaster@...) and belong to the domain name you're protecting. Comodo products only accept one email address.
Described below is how to retrieve a list of available values of approver emails.
Please note if your WHOIS contains any public email addresses, they will also be included in the response and can be used to confirm domain ownership.
Use endpoint path below. Base URL is determined by both the target environment and API version.
GET {base_url}/ssl/approver-emails?product_id={product_id}&domain={domain}
REQUEST VALUES↓
Name |
Type |
Values |
Description |
---|---|---|---|
product_id | integer | One or two digits. | Product. Check product list. |
domain | string | Domain name value. | Domain name value. |
REQUEST EXAMPLE↓
curl -X GET \
https://api.openprovider.eu/v1beta/ssl/approver-emails?domain=myexample.com&product_id=31 \
-H 'Authorization: Bearer 2831a37fb8*******90b5aac822' \
-H 'Content-Type: application/json' \
RESPONSE EXAMPLE↓
{
"code": 0,
"desc": "",
"data": {
"results": [
"admin@myexample.com",
"administrator@myexample.com",
"hostmaster@myexample.com",
"postmaster@myexample.com",
"webmaster@myexample.com",
]
}
}
RESPONSE VALUES↓
Name |
Type |
Description |
---|---|---|
code |
integer |
API Result with code returned. |
data |
array of string | An array of string. |
desc |
string | The description. |
maintenance |
boolean | Indicates if Openprovider is under maintenance mode. |
1. warnings |
An array | An array of warning messages. |
1.1 code | integer | Warning code value (digits). |
1.2 data | string | Data (additional warning description) value returned. |
1.3 desc | string | The description value returned. |
Once we got familiar with a list of approved email addresses please move to next step,
"4 Creating SSL Order" and submit our order creation request.