Use this endpoint to request an email with the site seal code for an order. DigiCert emails the code to the user associated with the API key in the header.
Secure Site and Secure Site Pro SSL/TLS certificates support the option to display a DigiCert Smart Seal on your website. The DigiCert Smart Seal is enabled for Secure Site and Secure Site Pro certificates when the seal_number
parameter is set to a value of 18
. To switch to a basic site seal, set the seal_number
parameter to a value of 15
(Norton), 16
(GeoTrust), or 17
(Thawte).
You can set the size or brand of the site seal when you request an email with the site seal code. To change other site seal settings, you can use the Update site seal settings endpoint.
Some modifications, such as changing the size of the site seal, do not require you to reinstall the site seal code.* Changes automatically appear within two hours of submitting the update. However, if you modify the hover effect, you must reinstall the site seal code for those changes to take effect on your website.
Hover effect modifications include:
seal_hover
).*Note
On March 25, 2021, DigiCert improved how CertCentral stores your site seal settings. Now, you can update most of the settings for your site seal without replacing the site seal code on your website (see Updating your site seal). This change affects all site seal codes you receive and implement after March 25, 2021.
For codes you received and implemented before March 25, 2021:
If you don’t change the settings for your site seal:
If you update the settings for your site seal via CertCentral or the Services API:
Changes may take up to two hours to appear on websites that use the new seal code.
curl -X POST \
https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}'
import requests
url = "https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal"
payload={}
headers = {
'X-DC-DEVKEY': {{api_key}},
'Content-Type': "application/json"
}
response = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal"
method := "POST"
client := &http.Client {
}
req, err := http.NewRequest(method, url, nil)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("X-DC-DEVKEY", {{api_key}})
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal',
'headers': {
'X-DC-DEVKEY': {{api_key}},
'Content-Type': 'application/json
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
// empty
Name | Type | Description |
---|---|---|
order_id | string | ID of the order associated with the seal. |
Name | Req/Opt | Type | Description |
---|---|---|---|
seal_hash | optional | string | Hash of the site seal associated with the order. |
seal_number | optional | int |
Number that identifies the type of seal to display. Allowed values:
|
seal_size | optional | string |
Site seal size. Allowed values:
|
seal_color Deprecated* |
optional | string |
Color of the site seal text. *DigiCert has deprecated the seal_color parameter. We ignore this parameter in calls to the Email site seal endpoint.
|
seal_language Deprecated* |
optional | string |
Language of the site seal pop-up. *DigiCert has deprecated the seal_language parameter. We ignore this parameter in calls to the Email site seal endpoint. See Set the language preference for the site seal information page.
|