Ordina DV SSL

POST

https://www.digicert.com/services/v2/order/certificate/{{dv_ssl_certificate_id}}

Questa pagina descrive i prodotti con il nome gruppo dv_ssl_certificate (consulta Glossario – Identificatori prodotto).

Usa questo endpoint per inviare un ordine di richiesta certificato DV usando ssl_dv_geotrust, ssl_dv_rapidssl, wildcard_dv_geotrust, wildcard_dv_rapidssl, o cloud_dv_geotrust come dv_ssl_certificate_id.

cURL

curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{dv_ssl_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "example.com",
        "dns_names": [
        	"sub.example.com",
        	"log.example.com"
        ],
        "csr": "<csr>",
        "server_platform": {
            "id": 2
        }
    },
    "custom_expiration_date": "",
    "comments": "Message for the approver.",
    "container": {
        "id": 69748
    },
    "custom_renewal_message": "Renew me.",
    "skip_approval": true,
    "disable_ct": 0,
    "validity_years": 1,
    "custom_fields": [
        {
            "metadata_id": 12,
            "value": "Invoice #12345"
        }
    ],
    "payment_method": "balance",
    "dcv_method": "email",
    "dcv_emails": [
    	{
    		"dns_name": "example.com",
    		"email_domain": "example.com",
    		"email": "admin@example.com"
    	},
    	{
    		"dns_name": "sub.example.com",
    		"email_domain": "example.com",
    		"email": "jim.smith@example.com"
    	},
    	{
    		"dns_name": "log.example.com",
    		"email_domain": "example.com",
    		"email": "it@example.com"
    	}
    ],
    "locale": "en",
    "technical_contact": {
        "first_name": "Jim",
        "last_name": "Smith",
        "telephone": "555-555-5555",
        "job_title": "IT Admin",
        "email": "jim.smith@example.com"
    }
}'

Python

import requests

url = "https://www.digicert.com/services/v2/order/certificate/{{dv_ssl_certificate_id}}"

payload = "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\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/{{dv_ssl_certificate_id}}"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\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))

}

NodeJS

var request = require("request");

var options = { method: 'POST',
  url: 'https://www.digicert.com/services/v2/order/certificate/{{dv_ssl_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'example.com',
        dns_names: [ 'sub.example.com', 'log.example.com' ],
        csr: '<csr>',
        server_platform: { id: 2 } },
     custom_expiration_date: '',
     comments: 'Message for the approver.',
     container: { id: 69748 },
     custom_renewal_message: 'Renew me.',
     skip_approval: true,
     disable_ct: 0,
     validity_years: 1,
     custom_fields: [ { metadata_id: 12, value: 'Invoice #12345' } ],
     payment_method: 'balance',
     dcv_method: 'email',
     dcv_emails: 
      [ { dns_name: 'example.com',
          email_domain: 'example.com',
          email: 'admin@example.com' },
        { dns_name: 'sub.example.com',
          email_domain: 'example.com',
          email: 'jim.smith@example.com' },
        { dns_name: 'log.example.com',
          email_domain: 'example.com',
          email: 'it@example.com' } ],
     locale: 'en',
     technical_contact: 
      { first_name: 'Jim',
        last_name: 'Smith',
        telephone: '555-555-5555',
        job_title: 'IT Admin',
        email: 'jim.smith@example.com' } },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

201 Created (email)

{
  "id": 6484932,
  "certificate_id": 6079436
}

201 Created (dns-txt-token or http-token)

{
  "id": 6484932,
  "certificate_id": 6079436
  "dcv_random_value": "icru1984rnekfj"
}

Parametri richiesta

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
certificate	obbligatorio	object	Dettagli certificato.
.. 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).
.. organization_units	facoltativo	array	Reparto dell’organizzazione a cui è rivolto il certificato.
.. server_platform	facoltativo	object	Tipo di piattaforma server. 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.
auto_renew	facoltativo	int	Specifica se il certificato deve rinnovarsi automaticamente. Predefinita: `0` Valori consentiti: `0` (disabilitata), `1` (abilitata)
custom_renewal_message	facoltativo	string	Messaggio personalizzato da includere nelle notifiche di rinnovo.
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.
payment_method	facoltativo	string	Specifica il metodo di pagamento da usare. Valori consentiti: `balance`, `card`, `profile` Predefinita: `balance`
dcv_method	obbligatorio	string	Metodo DCV da usare quando si verifica il controllo dominio. Consulta Glossario — Metodi DCV
dcv_emails	facoltativo	array	Elenco che specifica l’ambito e-mail quando si inviano delle e-mail DCV. Puoi aggiungere una voce per ciascun nome DNS che viene protetto dal certificato.
.. dns_name	obbligatorio	string	Nome DNS riportato sul certificato a cui si applica questo ambito.
.. email_domain	obbligatorio	string	Record di dominio WHOIS da usare per verificare gli indirizzi e-mail. Questo valore deve corrispondere al dominio base `dns_names`.
.. email	facoltativo	string	Indirizzi e-mail da usare quando si inviano delle e-mail DCV. Questo indirizzo e-mail deve comparire sul record WHOIS per il dominio specificato nel parametro `email_domain`.
locale	facoltativo	string	Lingua che l’e-mail DCV deve usare. Consulta Glossario — Codici luogo
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`
container	facoltativo	object	Se necessario, specificare il contenitore in cui deve essere posizionato l’ordine.
.. id	obbligatorio	int	ID contenitore.
custom_fields	facoltativo*	array	Campi personalizzati specifici dell’account. *L’obbligatorietà di questi campi dipende dalle impostazioni dei campi personalizzati.
.. metadata_id	obbligatorio	int	ID campo personalizzato.
.. value	obbligatorio	string	Valore per il campo personalizzato. Il tipo di convalida dati dipende dalle impostazioni dei campi personalizzati.
technical_contact	facoltativo	object	Dettagli contatto tecnico.
.. first_name	obbligatorio	stringa
.. last_name	obbligatorio	stringa
.. telephone	obbligatorio	stringa
.. job_title	facoltativo	stringa
.. email	obbligatorio	stringa

Parametri di risposta

Nome	Tipo	Descrizione
id	int	ID ordine.
certificate_id	int	ID certificato.
dcv_random_value	string	Valore casuale usato per il controllo dominio convalida. Riportato solo quando si usa `dns-txt-token` o `http-token` come metodo DCV.

Parametri richiesta

Parametri di risposta

Informazioni