Informazioni sull’ordine

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

Puoi sostituire {{order_id}} con un’identificazione personale del certificato o un numero di serie per ricevere le informazioni per l’ordine di certificato specificato.

Usa questo endpoint per ottenere i dettagli per un ordine di certificato.

Le informazioni di contatto tecnico vengono copiate dal contatto organizzazione.

cURL
curl -X GET \
  https://www.digicert.com/services/v2/order/certificate/{{order_id}}\
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
Python
import requests

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

headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
Go
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	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: 'GET',
  url: 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' } };

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

  console.log(body);
});
200 OK (needs_approval)
{
  "id": 123456,
  "certificate": {
    "common_name": "example.com",
    "dns_names": [
      "example2.com",
      "example3.com"
    ],
    "date_created": "2018-10-16T20:05:28+00:00",
    "csr": "<csr>",
    "organization": {
      "id": 112233
    },
    "organization_units": [
      "Not Fake Company Inc."
    ],
    "server_platform": {
      "id": -1,
      "name": "OTHER",
      "install_url": "http://www.digicert.com/SSL-certificate-installation.htm",
      "csr_url": "http://www.digicert.com/csr-creation.htm"
    },
    "signature_hash": "sha256",
    "key_size": 2048,
    "ca_cert": {
      "id": "<cert_id>",
      "name": "DigiCert SHA2 Secure Server CA"
    }
  },
  "status": "needs_approval",
  "is_renewal": false,
  "date_created": "2018-10-16T20:05:28+00:00",
  "organization": {
    "id": 112233,
    "name": "Epigyne Unwieldiness llc",
    "assumed_name": "Epigyne Unwieldiness",
    "display_name": "Epigyne Unwieldiness llc (Epigyne Unwieldiness)",
    "city": "Minneapolis",
    "state": "mn",
    "country": "us"
  },
  "validity_years": 1,
  "disable_renewal_notifications": false,
  "auto_renew": 0,
  "container": {
    "id": 15,
    "name": "History Department",
    "is_active": true
  },
  "product": {
    "name_id": "ssl_plus",
    "name": "Standard SSL",
    "type": "ssl_certificate",
    "validation_type": "ov",
    "validation_name": "OV",
    "validation_description": "Normal Organization Validation",
    "csr_required": true
  },
  "organization_contact": {
    "first_name": "Gia",
    "last_name": "Booth",
    "email": "gia.booth@inbox.com",
    "job_title": "Clinical Laboratory Technician",
    "telephone": "666-186-6450",
    "telephone_extension": "736"
  },
  "technical_contact": {
    "first_name": "Gia",
    "last_name": "Booth",
    "email": "gia.booth@inbox.com",
    "job_title": "Clinical Laboratory Technician",
    "telephone": "666-186-6450",
    "telephone_extension": "736"
  },
  "user": {
    "id": 44,
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@digicert.com"
  },
  "purchased_dns_names": 2,
  "requests": [
    {
      "id": 198,
      "date": "2018-10-16T20:05:28+00:00",
      "type": "new_request",
      "status": "pending",
      "comments": "Certificate comment."
    }
  ],
  "public_id": "<public_id>",
  "is_out_of_contract": false,
  "payment_method": "balance",
  "product_name_id": "ssl_plus",
  "custom_fields": [
    {
      "metadata_id": 12,
      "label": "Invoice #",
      "value": "123456"
    }
  ],
  "disable_issuance_email": false
}
200 OK (issued)
{
  "id": 123456,
  "certificate": {
    "common_name": "example.com",
    "dns_names": [
      "example2.com",
      "example3.com"
    ],
    "date_created": "2019-04-30T18:02:50+00:00",
    "valid_from": "2019-04-30",
    "valid_till": "2020-04-30",
    "days_remaining": 289,
    "csr": "<csr>",
    "organization": {
      "id": 112233
    },
    "organization_units": [
      "Not Fake Company Inc."
    ],
    "server_platform": {
      "id": -1,
      "name": "OTHER",
      "install_url": "http://www.digicert.com/SSL-certificate-installation.htm",
      "csr_url": "http://www.digicert.com/csr-creation.htm"
    },
    "signature_hash": "sha256",
    "key_size": 2048,
    "user_id": 12345
  },
  "status": "issued",
  "is_renewal": false,
  "date_created": "2019-04-30T18:02:50+00:00",
  "organization": {
    "id": 112233,
    "name": "Epigyne Unwieldiness llc",
    "assumed_name": "Epigyne Unwieldiness",
    "display_name": "Epigyne Unwieldiness llc (Epigyne Unwieldiness)",
    "city": "Minneapolis",
    "state": "mn",
    "country": "us"
  },
  "validity_years": 1,
  "disable_renewal_notifications": false,
  "auto_renew": 0,
  "container": {
    "id": 15,
    "name": "History Department",
    "is_active": true
  },
  "product": {
    "name_id": "ssl_plus",
    "name": "Standard SSL",
    "type": "ssl_certificate",
    "validation_type": "ov",
    "validation_name": "OV",
    "validation_description": "Normal Organization Validation",
    "csr_required": true
  },
  "organization_contact": {
    "first_name": "Gia",
    "last_name": "Booth",
    "email": "gia.booth@inbox.com",
    "job_title": "Clinical Laboratory Technician",
    "telephone": "666-186-6450",
    "telephone_extension": "736"
  },
  "technical_contact": {
    "first_name": "Gia",
    "last_name": "Booth",
    "email": "gia.booth@inbox.com",
    "job_title": "Clinical Laboratory Technician",
    "telephone": "666-186-6450",
    "telephone_extension": "736"
  },
  "user": {
    "id": 44,
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@digicert.com"
  },
  "purchased_dns_names": 2,
  "requests": [
    {
      "id": 198,
      "date": "2018-10-16T20:05:28+00:00",
      "type": "new_request",
      "status": "pending",
      "comments": "Certificate comment."
    }
  ],
  "public_id": "<public_id>",
  "is_out_of_contract": false,
  "payment_method": "balance",
  "product_name_id": "ssl_plus",
  "custom_fields": [
    {
      "metadata_id": 12,
      "label": "Invoice #",
      "value": "123456"
    }
  ],
  "disable_issuance_email": false
}

Parametri di risposta

Nome Tipo Descrizione
id int ID ordine.
certificate object Dettagli sul certificato.
.. id int ID certificato.
.. thumbprint string Identificazione personale del certificato.
.. serial_number * string Numero di serie del certificato.
.. common_name string Nome protetto dal certificato.
.. emails array Elenco delle e-mail associate al certificato.
.. dns_names array Elenco degli altri nomi protetti dal certificato.
.. date_created string Indicazione di data e ora di quando è stato creato il certificato.
Formato: Fuso orario UTC e data ISO 8601
.. valid_from * string Data in cui inizia la validità del certificato.
Formato: yyyy-MM-dd
.. valid_till * string Data di scadenza del certificato.
Formato: yyyy-MM-dd
.. days_remaining int Numero di giorni alla scadenza del certificato.
.. csr string Richiesta di firma certificato.
.. organization object Organizzazione sul certificato.
.. .. id int ID organizzazione.
.. organization_units array Elenco delle unità organizzative indicate sul certificato.
.. server_platform object Dettagli sulla piattaforma server.
.. .. id int ID piattaforma server.
Consulta Glossario — Piatteforme server
.. .. name string Nome della piattaforma server.
.. .. install_url string URL per le istruzioni di installazione certificato.
.. .. csr_url string URL per le istruzioni di generazione CSR.
.. signature_hash string Algoritmo di firma usato dal certificato.
.. key_size int Numero di bit usati nella chiave.
.. ca_cert object Certificato dell’autorità di certificazione (CA) usato per firmare il certificato.
.. .. id string ID certificato CA.
.. .. name string Nome della CA.
status string Stato dell’ordine.
Consulta Glossario — Stato ordine
is_renewal bool Specifica se l’ordine prevede un rinnovo.
is_renewed bool Specifica se l’ordine è stato rinnovato.
renewed_order_id int ID ordine dell’ordine precedente.
Riportato solo se l’ordine prevede un rinnovo.
date_created string Data di creazione ordine.
Formato: Fuso orario UTC e data ISO 8601
organization object Dettagli sull’organizzazione associata all’ordine.
.. id int ID organizzazione.
.. name string Ragione sociale dell’organizzazione.
.. assumed_name string Nome pubblico dell’organizzazione.
Chiamato anche nome DBA.
.. display_name string Nome completo dell’organizzazione.
Costruito usando nome + assumed_name.
.. city string Città in cui si trova l’organizzazione.
.. state string Stato in cui si trova l’organizzazione.
.. country string Paese in cui si trova l’organizzazione.
validity_years string Numero di anni in cui sarà valido il certificato.
disable_renewal_notifications bool Specifica se le notifiche di rinnovo sono abilitate.
auto_renew int Specifica se il rinnovo automatico è abilitato.
Valori possibili: 0 (disabilitata), 1 (abilitata)
container object Dettagli sul contenitore associato all’ordine.
.. id int ID contenitore.
.. name string Nome del contenitore.
.. is_active bool Stato attivo del contenitore.
product object Dettagli sul prodotto ordinato.
.. name_id string ID nome del prodotto.
Consulta Glossario — Identificatori di prodotto
.. name string Nome di visualizzazione del prodotto.
Consulta Glossario — Identificatori di prodotto
.. type string Tipo di prodotto.
Consulta Glossario — Tipi di Prodotto
.. validation_type string Tipo di convalida usato dal prodotto.
Consulta Glossario — Tipi di convalida
.. validation_name string Nome di visualizzazione del tipo di convalida.
.. validation_description string Descrizione del tipo di convalida.
.. csr_required bool Specifica se è necessaria una CSR per il tipo di prodotto.
organization_contact object Dettagli sul contatto dell'organizzazione associato all’ordine.
Consulta Strutture — Oggetto dettagli contatto.
technical_contact object Dettagli sul contatto tecnico associato all’ordine.
Consulta Strutture — Oggetto dettagli contatto.
user object Dettagli sull’utente che ha inviato l’ordine.
Consulta Strutture — Oggetto dettagli utente.
purchased_dns_names int Numero di altri SAN acquistati.
requests array Elenco degli oggetti contenenti i dettagli sulla richiesta ordine.
.. .. id int
.. .. date stringa
.. .. type stringa
.. .. status stringa
.. .. comments stringa
receipt_id int ID ricevuta.
cs_provisioning_method string Per gli ordini di firma documento e firma codice EV, specifica il metodo con cui sarà inviato il token.
Consulta Glossario — Metodi di provisioning CS
public_id string ID usato per le installazioni rapide.
allow_duplicates bool Specifica se l’ordine consente certificati duplicati.
user_assignments Elenco degli utenti che hanno creato o che sono stati assegnati all’ordine.
Consulta Strutture — Oggetto dettagli utente.
is_out_of_contract bool Stato del contratto dell’ordine.
payment_method string Metodo di pagamento usato per l’ordine.
Valori possibili: balance (Saldo account), credit (carta di credito), profile (pagamento predefinito account)
product_name_id string ID nome del prodotto.
Consulta Glossario — Identificatori di prodotto
custom_fields array Elenco dei dati dei campi personalizzati.
.. metadata_id int ID metadati dei campi personalizzati.
.. label string Nome del campo personalizzato.
.. value string Valore inserito per il campo personalizzato.
disable_issuance_email bool Specifica se vengono inviate le e-mail di emissione.
disable_ct bool Specifica se il certificato sarà registrato nei registri CT pubblici.
api_key object Specifica se l’ordine è stato richiesto tramite Services API o ACME.
Omesso se l’ordine è stato richiesto tramite un altro metodo (ad es. account CertCentral, URL di richiesta guest, ecc.).
.. name string Nome della chiave API o URL directory ACME.
.. key_type string Tipo di chiave usata per la richiesta.
Valori possibili: api_key (API), acme_url (ACME)

* - Riportato solo per gli ordini di certificato emessi.