Verwenden Sie diesen Endpunkt, um ein Secure Site Pro SSL-Zertifikat zu beantragen.
curl -X POST \
https://www.digicert.com/services/v2/order/certificate/ssl_securesite_flex \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
"certificate": {
"common_name": "example.com",
"dns_names": [
"sub.example.com",
"app.example.com"
],
"csr": "<csr>",
"signature_hash": "sha256",
"organization_units": [
"Shared Services"
],
"server_platform": {
"id": 2
}
},
"comments": "Certificate for app server.",
"container": {
"id": 334455
},
"auto_renew": 1,
"custom_renewal_message": "Keep this renewed.",
"organization": {
"id": 123456,
"contacts": [
{
"contact_type": "organization_contact",
"user_id": 565611
},
{
"contact_type": "technical_contact",
"first_name": "Jill",
"last_name": "Valentine",
"job_title": "STAR Member",
"telephone": "8017019600",
"email": "jill.valentine@digicert.com"
}
]
},
"validity_years": 2,
"payment_method": "balance"
}'
import requests
url = "https://www.digicert.com/services/v2/order/certificate/ssl_securesite_pro"
payload = "{\n \"certificate\": {\n \"common_name\": \"example.com\",\n \"dns_names\": [\n \"example2.com\",\n \"example3.com\"\n ],\n \"csr\": \"<csr>\",\n \"signature_hash\": \"sha256\",\n \"organization_units\": [\n \"Shared Services\"\n ],\n \"server_platform\": {\n \"id\": 2\n }\n },\n \"comments\": \"Certificate for app server.\",\n \"container\": {\n \"id\": 334455\n },\n \"auto_renew\": 1,\n \"custom_renewal_message\": \"Keep this renewed.\",\n \"organization\": {\n \"id\": 123456,\n \"contacts\": [\n {\n \"contact_type\": \"organization_contact\",\n \"user_id\": 565611\n },\n {\n \"contact_type\": \"technical_contact\",\n \"first_name\": \"Jill\",\n \"last_name\": \"Valentine\",\n \"job_title\": \"STAR Member\",\n \"telephone\": \"8017019600\",\n \"email\": \"jill.valentine@digicert.com\"\n }\n ]\n },\n \"validity_years\": 2,\n \"payment_method\": \"balance\"\n}"
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/ssl_securesite_pro"
payload := strings.NewReader("{\n \"certificate\": {\n \"common_name\": \"example.com\",\n \"dns_names\": [\n \"example2.com\",\n \"example3.com\"\n ],\n \"csr\": \"<csr>\",\n \"signature_hash\": \"sha256\",\n \"organization_units\": [\n \"Shared Services\"\n ],\n \"server_platform\": {\n \"id\": 2\n }\n },\n \"comments\": \"Certificate for app server.\",\n \"container\": {\n \"id\": 334455\n },\n \"auto_renew\": 1,\n \"custom_renewal_message\": \"Keep this renewed.\",\n \"organization\": {\n \"id\": 123456,\n \"contacts\": [\n {\n \"contact_type\": \"organization_contact\",\n \"user_id\": 565611\n },\n {\n \"contact_type\": \"technical_contact\",\n \"first_name\": \"Jill\",\n \"last_name\": \"Valentine\",\n \"job_title\": \"STAR Member\",\n \"telephone\": \"8017019600\",\n \"email\": \"jill.valentine@digicert.com\"\n }\n ]\n },\n \"validity_years\": 2,\n \"payment_method\": \"balance\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
var request = require("request");
var options = { method: 'POST',
url: 'https://www.digicert.com/services/v2/order/certificate/ssl_securesite_pro',
headers:
{ 'Content-Type': 'application/json',
'X-DC-DEVKEY': '{{api_key}}' },
body:
{ certificate:
{ common_name: 'example.com',
dns_names: [ 'example2.com', 'example3.com' ],
csr: '<csr>',
signature_hash: 'sha256',
organization_units: [ 'Shared Services' ],
server_platform: { id: 2 } },
comments: 'Certificate for app server.',
container: { id: 334455 },
auto_renew: 1,
custom_renewal_message: 'Keep this renewed.',
organization:
{ id: 123456,
contacts:
[ { contact_type: 'organization_contact', user_id: 565611 },
{ contact_type: 'technical_contact',
first_name: 'Jill',
last_name: 'Valentine',
job_title: 'STAR Member',
telephone: '8017019600',
email: 'jill.valentine@digicert.com' } ] },
validity_years: 2,
payment_method: 'balance' },
json: true };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "pending"
}
]
}
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "submitted"
}
]
}
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "approved"
}
],
"certificate_id": 113
}
{
"id": 112233,
"certificate_id": 113
}
{
"id": 112233,
"certificate_id": 113,
"certificate_chain": [
{
"subject_common_name": "example.com",
"pem": "<pem_certificate>"
},
{
"subject_common_name": "DigiCert SHA2 Secure Server CA",
"pem": "<pem_certificate>"
},
{
"subject_common_name": "DigiCert Global Root CA",
"pem": "<pem_certificate>"
}
]
}
Informationen über zulässige Werte für die Zertifikatsfelder: Öffentlich vertrauenswürdige Zertifikate – Dateneinträge, die gegen Branchenstandards verstoßen.
Name | Antr./Opt. | Typ | Beschreibung |
---|---|---|---|
certificate | erforderlich | object | Zertifikatsdetails |
.. common_name | erforderlich | string | Zu schützende Domäne. |
.. dns_names | optional | array |
Weitere zu schützende Domänen. Kann zusätzliche Kosten verursachen. (Siehe Best Practices – Beide Versionen einer Domäne kostenlos erhalten.) |
.. csr | erforderlich | string | CSR (Certificate Signing Request) |
.. signature_hash | erforderlich | string |
Zum Signieren des Zertifikats verwendeter Hash-Algorithmus. Code Signing-Zertifikate unterstützen nur SHA-256. |
.. organization_units | optional | array | Abteilung in Ihrem Unternehmen, für die das Zertifikat bestimmt ist. |
.. server_platform | optional | object |
Serverplattformtyp. Standard: -1 (andere)
|
.. .. id | erforderlich | int |
Serverplattform-ID Siehe Glossar – Serverplattformen |
.. profile_option | optional | string | Falls Sie benutzerdefinierte Zertifikatsprofile verwenden, geben Sie den Namen des Profils an. |
renewed_thumbprint | optional | string | Falls der Auftrag eine Verlängerung betrifft, geben Sie den SHA-1-Fingerabdruck des primären Zertifikats des vorherigen Auftrags ein. |
validity_years | erforderlich | int |
Die Laufzeit des Zertifikats in Jahren Kann durch validity_days oder custom_expiration_date ersetzt werden.Zulässige Werte: 1 , 2
|
custom_expiration_date | optional | string |
Benutzerdefiniertes Ablaufdatum für das Zertifikat. Das Datum muss weniger als 825 Tage in der Zukunft liegen. Setzt validity_days und validity_years außer KraftFormat: yyyy-MM-dd
|
comments | optional | string | Anmerkungen zum Auftrag für den Genehmiger. |
auto_renew | optional | int |
Soll das Zertifikat automatisch erneuert werden? Standard: 0 Zulässige Werte: 0 (deaktiviert), 1 (aktiviert)
|
custom_renewal_message | optional | string | Benutzerdefinierte Nachricht, die in die Verlängerungsbenachrichtigungen aufgenommen werden soll. |
disable_renewal_notifications | optional | bool |
Sollen Verlängerungsbenachrichtigungen per E-Mail deaktiviert werden? Standard: false
|
additional_emails | optional | array | Zusätzliche E-Mail-Adressen, die Zertifikatsbenachrichtigungen erhalten sollen (z. B. Zertifikatsausstellung, Zweitzertifikat, Zertifikatsverlängerung usw.). |
locale | optional | string |
Sprache, die in der DCV-E-Mail verwendet werden soll Siehe Glossar – Gebietsschemacodes |
renewal_of_order_id | optional | int | Falls der Auftrag eine Verlängerung betrifft, geben Sie die ID des vorherigen Auftrags ein. |
payment_method | optional | string |
Geben Sie die zu verwendende Zahlungsmethode an. Zulässige Werte: balance , card , profile Standard: balance
|
dcv_method | optional | string |
Zu verwendende DCV-Methode zur Bestätigung der Domänenkontrolle Siehe Glossar – DCV-Methoden |
skip_approval | optional | bool |
Soll der Auftrag den Genehmigungsschritt überspringen und sofort nach der unverzüglichen Validierung ausgestellt werden? Standard: false
|
disable_ct | optional | bool |
Soll die CT-Protokollierung für das Zertifikat deaktiviert werden? Die auftragsspezifische CT-Protokollierung muss aktiviert sein, sonst wird dieser Punkt ignoriert. Siehe Benutzern gestatten, Zertifikate von der CT-Protokollierung auszuschließen. Standard: false
|
organization | erforderlich | object | Container für Organisationsdetails. |
.. id | erforderlich | int |
ID der mit dem Auftrag zu verknüpfenden Organisation. Alternativ können Sie ein „Organisation“-Objekt einreichen, um eine neue Organisation hinzuzufügen, wenn Sie den Auftrag erteilen. Siehe Organisation erstellen, um die Anforderungen an die Objektstruktur zu erfahren. |
.. contacts | optional | array |
Liste der Organisationskontakte für den Auftrag. Hinweis: Falls er fehlt, wird der Standardkontakt für die angegebene Organisation verwendet. |
.. .. contact_type | erforderlich | string |
Anzugebender Kontakttyp. Zulässige Werte: organization_contact , technical_contact , ev_approver
|
.. .. user_id | erforderlich* | int |
ID des vorhandenen Benutzers oder Kontakts für das Konto. * Kann bei Hinzufügen eines neuen Kontakts weggelassen werden. |
.. .. first_name | optional | string |
Vorname des neuen Kontakts. Hinweis: Erforderlich, wenn user_id weglassen. Falls user_id nicht weggelassen wurde, werden die Informationen des angegebenen Benutzers mit dem neuen Wert aktualisiert.
|
.. .. last_name | optional | string |
Nachname des neuen Kontakts. Hinweis: Erforderlich, wenn user_id weglassen. Falls user_id nicht weggelassen wurde, werden die Informationen des angegebenen Benutzers mit dem neuen Wert aktualisiert.
|
.. .. job_title | optional | string |
Funktion des neuen Kontakts. Hinweis: Erforderlich, wenn user_id weglassen. Falls user_id nicht weggelassen wurde, werden die Informationen des angegebenen Benutzers mit dem neuen Wert aktualisiert.
|
.. .. telephone | optional | string |
Telefonnummer des neuen Kontakts. Hinweis: Erforderlich, wenn user_id weglassen. Falls user_id nicht weggelassen wurde, werden die Informationen des angegebenen Benutzers mit dem neuen Wert aktualisiert.
|
optional | string |
E-Mail-Adresse des neuen Kontakts. Hinweis: Erforderlich, wenn user_id weglassen. Falls user_id nicht weggelassen wurde, werden die Informationen des angegebenen Benutzers mit dem neuen Wert aktualisiert.
|
|
container | optional | object | Geben Sie ggf. den Container an, unter dem der Auftrag platziert werden soll. |
.. id | erforderlich | int | Container-ID |
custom_fields | optional* | array |
Kontospezifische benutzerdefinierte Felder. * Ob diese Felder erforderlich sind, hängt von den Einstellungen Ihrer benutzerdefinierten Felder ab. |
.. metadata_id | erforderlich | int | ID des benutzerdefinierten Felds |
.. value | erforderlich | string |
Wert für das benutzerdefinierte Feld Der Datenvalidierungstyp hängt von den Einstellungen Ihrer benutzerdefinierten Felder ab. |
Name | Typ | Beschreibung |
---|---|---|
id | int | Auftrags-ID |
organization | object |
Container für Details einer neuen Organisation. Wird nur zurückgegeben, falls mit dem Auftrag eine neue Organisation erstellt wurde. |
.. id | int | ID für die neue Organisation. |
requests | array | Enthält Informationen zu dem Antrag |
.. id | int | Antrags-ID. |
.. status | string |
Antragsstatus Mögliche Werte: pending , submitted , approved , rejected
|
certificate_id | int |
Zertifikats-ID Wird zurückgegeben, falls der Antragsstatus approved ist
|