Email site seal
2 minute read
POST
Use this endpoint to send an email with the site seal code for an order. By default, DigiCert emails the site seal code to the authenticated user (the user that owns the API key in the request header). To choose a different recipient, use the optional https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal
recipient_email request parameter.Tip
Updating your site seal
To change the settings for a site seal, use the Update site seal settings endpoint.
Alternately, you can change the settings for a site seal with the same API request you use to email the site seal. The Email site seal endpoint honors the same request parameters as the Update site seal settings endpoint. See Update site seal settings for descriptions of these parameters and usage information.
Related topics
- Get site seal settings
- Update site seal settings
- Upload site seal logo
- Site seal installation instructions
Example requests and responses
curl 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal/email-seal' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"recipient_email": "john.doe@example.com"
}'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);
});204 No Content
// empty
Path parameters
| Name | Type | Description |
|---|---|---|
| order_id | string | ID of the order associated with the seal. |
Request parameters
| Name | Req/Opt | Type | Description |
|---|---|---|---|
| recipient_email | optional | string | Email address of the site seal recipient. Must be a string containing a single email address. If omitted, DigiCert sends the site seal code to the authenticated user (the user that owns the API key in the request header). If a recipient_email is present in your request body, the endpoint is throttled. If you exceed the throttle limit, CertCentral returns an HTTP response status code of 429 Too Many Requests . |
Was this page helpful?
Provide feedback