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)

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.

Paramètres de réponse

À propos de