Informations de commande

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

Vous pouvez remplacer {{order_id}} par l'empreinte ou le numéro de série d'un certificat pour obtenir des informations sur la commande de certificats spécifiée.

Appelez ce point de terminaison pour obtenir les détails relatifs à une commande de certificat.

Les informations concernant le contact technique sont copiées à partir du contact de l’organisation.

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
}

Paramètres de réponse

Nom Type Description
id int ID de la commande
certificate object Détails relatifs au certificat
.. id int ID du certificat
.. thumbprint string Empreinte du certificat
.. serial_number * string Numéro de série du certificat
.. common_name string Nom protégé par le certificat
.. emails array Liste des adresses électroniques associées au certificat
.. dns_names array Liste des noms supplémentaires protégés par le certificat
.. date_created string Horodatage de création du certificat
Format : Fuseau horaire UTC et date ISO 8601
.. valid_from * string Date de début de validité du certificat
Format : yyyy-MM-dd
.. valid_till * string Date d’expiration du certificat
Format : yyyy-MM-dd
.. days_remaining int Nombre de jours avant l’expiration du certificat
.. csr string Demande de signature de certificat
.. organization object Organisation du certificat
.. .. id int ID de l’organisation
.. organization_units array Liste des unités organisationnelles du certificat
.. server_platform object Détails relatifs à la plate-forme serveur
.. .. id int Identificateur de la plate-forme serveur
Consultez le Glossaire — Plateformes serveurs.
.. .. name string Nom de la plate-forme serveur.
.. .. install_url string URL des instructions d’installation du certificat
.. .. csr_url string URL des instructions pour la génération d’une CSR
.. signature_hash string Algorithme de signature utilisé par le certificat
.. key_size int Nombre de bits utilisés dans la clé
.. ca_cert object Certificat de l’autorité de certification (AC) utilisée pour signer le certificat
.. .. id string Identifiant du certificat d’AC
.. .. name string Nom de l’autorité de certification.
status string Statut de la commande
Consultez le Glossaire — Statut de la commande
is_renewal bool Indique si la commande est un renouvellement.
is_renewed bool Indique si la commande a été renouvelée.
renewed_order_id int ID de la commande précédente
Renvoyé seulement si la commande est un renouvellement.
date_created string Date de création de la commande
Format : Fuseau horaire UTC et date ISO 8601
organization object Détails relatifs à l’organisation associée à la commande.
.. id int ID de l’organisation
.. name string Nom légal de l’organisation
.. assumed_name string Nom public de l’organisation
Également appelé « nom DBA »
.. display_name string Nom complet de l’organisation
Composé du nom + assumed_name.
.. city string Ville où est établie l’organisation
.. state string État où est établie l’organisation
.. country string Pays où est établie l’organisation
validity_years string Nombre d’années de validité du certificat
disable_renewal_notifications bool Indique si les notifications de renouvellement sont activées.
auto_renew int Indique si le renouvellement automatique est activé.
Valeurs possibles : 0 (désactivé), 1 (activé)
container object Détails relatifs au conteneur associé à la commande
.. id int ID du conteneur
.. name string Nom du conteneur
.. is_active bool Statut actif du conteneur
product object Détails relatif au produit commandé
.. name_id string ID du nom du produit
Consultez le Glossaire — Identificateurs de produits
.. name string Nom d’affichage du produit
Consultez le Glossaire — Identificateurs de produits
.. type string Type du produit
Consultez le Glossaire — Types de produits
.. validation_type string Type de validation utilisé pour le produit
Consultez le Glossaire — Types de validation
.. validation_name string Nom d’affichage du type de validation
.. validation_description string Description du type de validation
.. csr_required bool Indique si le type de produit requiert une CSR.
organization_contact object Détails relatifs au contact de l’organisation associé à la commande
Consultez la page Structures — Objet Détails du contact.
technical_contact object Détails relatifs au contact technique associé à la commande
Consultez la page Structures — Objet Détails du contact.
user object Détails relatifs à l’utilisateur qui a envoyé la commande
Consultez la page Structures — Objet Détails de l’utilisateur.
purchased_dns_names int Nombre de noms SAN supplémentaires achetés
requests array Liste des objets contenant des détails relatifs à la commande
.. .. id int
.. .. date Chaîne
.. .. type Chaîne
.. .. status Chaîne
.. .. comments Chaîne
receipt_id int ID du reçu
cs_provisioning_method string Pour les commandes de signature de code EV ou de document, indique la méthode avec laquelle le jeton sera envoyé.
Consultez le Glossaire — Méthodes d’approvisionnement CS
public_id string ID utilisé pour les installations rapides
allow_duplicates bool Indique si la commande autorise les duplicatas de certificat.
user_assignments Liste des utilisateurs qui ont crée ou ont été affectés à la commande.
Consultez la page Structures — Objet Détails de l’utilisateur.
is_out_of_contract bool Statut du contrat de la commande
payment_method string Mode de paiement utilisé pour la commande
Valeurs possibles : balance (prélèvement sur solde du compte), credit (carte bancaire), profile (paiement sur le compte par défaut)
product_name_id string ID du nom du produit
Consultez le Glossaire — Identificateurs de produits
custom_fields array Liste des données de champ personnalisé
.. metadata_id int ID des métadonnées de champ personnalisé
.. label string Nom du champ personnalisé
.. value string Valeur saisie pour le champ personnalisé
disable_issuance_email bool Indique si les courriers électroniques sont envoyés.
disable_ct bool Indique si le certificat sera enregistré dans les journaux CT.
api_key object Indique si la commande a été demandé via l’API Services ou ACME.
Omis si la commande a été demandée au moyen d’une autre méthode (par ex. un compte CertCentral, l’URL de demande invité, etc.).
.. name string Nom de la clé d’API ou URL du répertoire ACME
.. key_type string Type de clé utilisé pour la demande
Valeurs possibles : api_key (API), acme_url (ACME)

* - Renvoyé seulement pour les commandes dont les certificats ont été émis.