Upload Certificate
This API is used to upload SSL certificate with PEM-encoded body, private key and certificate chain.
1. Request Definition
- API URL
https://cdn-api.swiftfederation.com/v1.0/certificates
- Request Method
POST
- Request Header
Refer to HTTP Request Headers
- Request Body
Request Body Data Format: JSON
| Field | Required | Type | Description |
|---|---|---|---|
| customerId | Mandatory | int | Customer id for the certificate. |
| name | Mandatory | string | Certificate name. |
| type | Mandatory | string | Certificate type, "single": Single domain SSL, "wildcard": wildcard SSL, "san": Multiple domain SSL. |
| certificate | Mandatory | string | PEM-encoded certificate body contents. |
| privateKey | Mandatory | string | PEM-encoded certificate private key contents. |
| chain | Optional | string | PEM-encoded certificate chain contents. |
- Request Body Example
{
"customerId":10,
"name": "cdn.website2.com's domain",
"type": "single",
"certificate": "-----BEGIN CERTIFICATE-----\n
MIIFZDCCBEygAwIBAgISA6PdrA2Muc5kvNzK/BMUHzvJMA0GCSqGSIb3DQEBCwUA
................................................................
iI2EUsOChlBfmbSI/Ure4JNRV6BkDfvEehBJxieA6tq0RXj39TnaJQ==\n
-----END CERTIFICATE-----",
"privateKey": "-----BEGIN PRIVATE KEY-----\n
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDnePLDlJEVhlio
................................................................
wOFoFDpV0knjnI3/toPQT4I=\n
-----END PRIVATE KEY-----",
"chain": "-----BEGIN CERTIFICATE-----\n
MIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/
................................................................
KOqkqm57TH2H3eDJAkSnh6/DNFu0Qg==\n
-----END CERTIFICATE-----"
}
2. Response Definition
- Response Header
Refer to HTTP Response Headers
- Response Body
| Field | Type | Description |
|---|---|---|
| id | int | Certificate ID. |
| customerId | int | Customer ID of certificate. |
| name | string | Certificate name. |
| commonName | string | Certificate common name. |
| type | int | Certificate type, "single": Single domain SSL, "wildcard": wildcard SSL, "san": Multiple domain SAN SSL. |
| subjectAlternativeNames | string | Certificate subject alternative names. |
| serialNumber | string | Certificate serial number. |
| issuer | string | Certificate issuer. |
| organization | string | Certificate organization. |
| organizationalUnit | string | Certificate organizational unit. |
| country | string | Certificate country. |
| stateOrProvince | string | Certificate state or province. |
| locality | string | Certificate locality or city. |
| validFrom | string | The valid from date that cerficate can be used. |
| validTo | string | The expired date of cerficate. |
| created | string | The date that cerficate was created. |
- Response Body Example
{
"id": 101,
"customerId": 10,
"name": "www.website1.com",
"type": "single",
"commonName": "www.website1.com",
"subjectAlternativeNames": "DNS:www.website1.com",
"serialNumber": "273382759972166399460921282283500328610625",
"issuer": "Let's Encrypt Authority X3",
"organization": "Conversant",
"organizationalUnit": "Conversant",
"country": "Singapore",
"stateOrProvince": "Singapore",
"locality": "Singapore",
"validFrom": "2019-01-01T04:28:32Z",
"validTo": "2019-04-01T04:28:32Z",
"created": "2019-01-01T04:28:32Z"
}