Questo endpoint determina automaticamente il prodotto SSL appropriato per la richiesta in base ai dati inviati. Se non è possibile determinare un prodotto, viene riportato un errore 400 ambiguous_product
.
Usa questo endpoint per inviare una richiesta di certificato usando il prodotto type_hint
.
curl -X POST \
https://www.digicert.com/services/v2/order/certificate/ssl \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
"certificate": {
"common_name": "example.com",
"dns_names": [
"example2.com",
"example3.com"
],
"csr": "<csr>",
"signature_hash": "sha256",
"organization_units": [
"Not Fake Company Inc."
],
"organization": {
"id": 112233
},
"server_platform": {
"id": 2
}
},
"validity_years": 1,
"comments": "Example certificate for API documentation.",
"container": {
"id": 11
},
"product": {
"type_hint": "ov"
},
"auto_renew": 1,
"disable_renewal_notifications": false,
"additional_emails": [
"john.smith@digicert.com"
],
"disable_ct": false,
"skip_approval": true,
"organization": {
"id": 112233
}
}'
import requests
url = "https://www.digicert.com/services/v2/order/certificate/ssl"
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 \"Not Fake Company Inc.\"\n ],\n \"organization\": {\n \"id\": 112233\n },\n \"server_platform\": {\n \"id\": 2\n }\n },\n \"validity_years\": 1,\n \"comments\": \"Example certificate for API documentation.\",\n \"container\": {\n \"id\": 11\n },\n \"product\": {\n \"type_hint\": \"ov\"\n },\n \"auto_renew\": 1,\n \"disable_renewal_notifications\": false,\n \"additional_emails\": [\n \"john.smith@digicert.com\"\n ],\n \"disable_ct\": false,\n \"skip_approval\": true,\n \"organization\": {\n \"id\": 112233\n }\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"
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 \"Not Fake Company Inc.\"\n ],\n \"organization\": {\n \"id\": 112233\n },\n \"server_platform\": {\n \"id\": 2\n }\n },\n \"validity_years\": 1,\n \"comments\": \"Example certificate for API documentation.\",\n \"container\": {\n \"id\": 11\n },\n \"product\": {\n \"type_hint\": \"ov\"\n },\n \"auto_renew\": 1,\n \"disable_renewal_notifications\": false,\n \"additional_emails\": [\n \"john.smith@digicert.com\"\n ],\n \"disable_ct\": false,\n \"skip_approval\": true,\n \"organization\": {\n \"id\": 112233\n }\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',
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: [ 'Not Fake Company Inc.' ],
organization: { id: 112233 },
server_platform: { id: 2 } },
validity_years: 1,
comments: 'Example certificate for API documentation.',
container: { id: 11 },
product: { type_hint: 'ov' },
auto_renew: 1,
disable_renewal_notifications: false,
additional_emails: [ 'john.smith@digicert.com' ],
disable_ct: false,
skip_approval: true,
organization: { id: 112233 } },
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
}
Per informazioni sui valori consentiti per i campi del certificato, consulta Certificati attendibili pubblicamente – Dati inseriti che violano gli standard di settore.
Nome | Rich/Opz | Tipo | Descrizione |
---|---|---|---|
certificato | obbligatorio | oggetto | |
.. common_name | obbligatorio | string | Dominio da proteggere. |
.. dns_names | facoltativo | array |
Altri domini da proteggere. Può prevedere costi aggiuntivi. (Consulta Best practice — Richiedi gratuitamente entrambe le versioni di un dominio.) |
.. csr | obbligatorio* | string |
Richiesta di firma certificato (CSR). *Consulta Glossario — Requisiti CSR |
.. signature_hash | obbligatorio | string |
Algoritmo hash usato per firmare il certificato. I certificati di firma codice supportano solo SHA-256. |
.. ca_cert_id | obbligatorio* | string |
ID del certificato CA che deve firmare il certificato. *Obbligatorio solo se type_hint è private .
|
.. organization_units | facoltativo | array | Reparto dell’organizzazione a cui è rivolto il certificato. |
.. server_platform | facoltativo | object |
Tipo di piattaforma server. Obbligatorio per gli ordini di certificati di firma codice. Predefinita: -1 (altro)
|
.. .. id | obbligatorio | int |
ID piattaforma server. Consulta Glossario — Piatteforme server |
renewed_thumbprint | facoltativo | string | Se un ordine prevede un rinnovo, inserisci l’identificazione personale SHA-1 del certificato primario dell’ordine precedente. |
validity_years | obbligatorio | int |
Numero di anni in cui è valido il certificato. Può essere sostituito da validity_days o custom_expiration_date .Valori consentiti: 1 , 2
|
validity_days | facoltativo | int |
Numero di giorni in cui il certificato è valido dopo l’emissione. Sostituisce validity_years
|
custom_expiration_date | facoltativo | string |
Data di scadenza personalizzata per il certificato. La data deve essere inferiore a 825 giorni nel futuro. Sostituisce validity_days e validity_years Formato: yyyy-MM-dd
|
comments | facoltativo | string | Commenti sull’ordine per l’approvatore. |
prodotto | facoltativo | oggetto | |
.. type_hint | facoltativo | string |
Specifica il tipi di prodotto da passare. Valori consentiti: ov , ev , grid , private
|
auto_renew | facoltativo | int |
Specifica se il certificato deve rinnovarsi automaticamente. Predefinita: 0 Valori consentiti: 0 (disabilitata), 1 (abilitata)
|
disable_renewal_notifications | facoltativo | bool |
Specifica se le e-mail di notifica rinnovo devono essere disabilitate. Predefinita: false
|
additional_emails | facoltativo | array | Altri indirizzi e-mail per ricevere e-mail di notifica certificato (ad es. emissione del certificato, certificato duplicato, rinnovi certificato, ecc.). |
renewal_of_order_id | facoltativo | int | Se un ordine prevede un rinnovo, inserisci l’ID dell’ordine precedente. |
dcv_method | obbligatorio | string |
Metodo DCV da usare quando si verifica il controllo dominio. Consulta Glossario — Metodi DCV |
skip_approval | facoltativo | bool |
Specifica se l’ordine deve saltare la fase di approvazione ed essere inviato immediatamente per la convalida ed emesso se completato. Predefinita: false
|
disable_ct | facoltativo | bool |
Specifica se la registrazione CT per il certificato deve essere disabilitata. La registrazione CT specifica dell’ordine deve essere abilitata oppure verrà ignorata. Consulta Consenti sempre agli utenti di conservare i certificati fuori dai registri CT. Predefinita: false
|
organization | obbligatorio | object | Contenitore per i dettagli organizzazione. |
.. id | obbligatorio | int | ID dell’organizzazione da associare all’ordine. |
container | facoltativo | object | Se necessario, specificare il contenitore in cui deve essere posizionato l’ordine. |
.. id | obbligatorio | int | ID contenitore. |
Nome | Tipo | Descrizione |
---|---|---|
id | int | ID ordine. |
organization | object |
Contenitore per i nuovi dettagli organizzazione. Riportato solo se è stata creata una nuova organizzazione con l’ordine. |
.. id | int | ID organizzazione per la nuova organizzazione. |
requests | array | Contiene le informazioni sulla richiesta. |
.. id | int | ID richiesta |
.. status | string |
Stato richiesta. Valori possibili: pending , submitted , approved , rejected
|
certificate_id | int |
ID certificato. Riportato se lo stato richiesta. è approved .
|