Informations de commande

GET

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

You can replace {{order_id}} with a certificate's thumprint or serial number to get info for the specified certificate order.

Use this endpoint to get details for a certificate order.

Technical contact information is copied from the organization contact.

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
}

Response parameters

Name	Type	Description
id	int	Order ID.
certificate	object	Details about the certificate.
.. id	int	Certificate ID.
.. thumbprint	string	Thumbprint of the certificate.
.. serial_number *	string	Serial number of the certificate.
.. common_name	string	Name secured by the certificate.
.. emails	array	List of emails associated with the certificate.
.. dns_names	array	List of additional names secured by the certificate.
.. date_created	string	Timestamp of when the certificate was created. Format: UTC timezone and ISO 8601 date
.. valid_from *	string	Date when certificate validity starts. Format: `yyyy-MM-dd`
.. valid_till *	string	Expiration date of the certificate. Format: `yyyy-MM-dd`
.. days_remaining	int	Number of days until certificate expires.
.. csr	string	Certificate signing request.
.. organization	object	Organization on the certificate.
.. .. id	int	Organization ID.
.. organization_units	array	List of organization units on the certificate.
.. server_platform	object	Details about the server platform.
.. .. id	int	Server platform ID. See Glossary – Server platforms
.. .. name	string	Name of the server platform.
.. .. install_url	string	URL for Certificate installation instructions.
.. .. csr_url	string	URL for CSR generation instructions.
.. signature_hash	string	Signing algorithm used by the certificate.
.. key_size	int	Number of bits used in the key.
.. ca_cert	object	Certificate authority (CA) certificate used to sign the certificate.
.. .. id	string	CA certificate ID.
.. .. name	string	Name of the CA.
status	string	Status of the order. See Glossary – Order status
is_renewal	bool	Specifies if the order is a renewal.
is_renewed	bool	Specifies if the order has been renewed.
renewed_order_id	int	Order ID of the previous order. Returned only if order is a renewal.
date_created	string	Order creation date. Format: UTC timezone and ISO 8601 date
organization	object	Details about the organization associated with the order.
.. id	int	Organization ID.
.. name	string	Legal name of the organization.
.. assumed_name	string	Public name of the organization. Also called DBA name.
.. display_name	string	Full name of the organization. Constructed using name + assumed_name.
.. city	string	City where the organization is located.
.. state	string	State where the organization is located.
.. country	string	Country where the organization is located.
validity_years	string	Number of years the certificate will be valid.
disable_renewal_notifications	bool	Specifies if renew notifications are enabled.
auto_renew	int	Specifies if auto renew is enabled. Possible values: `0` (disabled), `1` (enabled)
container	object	Details about the container associated with the order.
.. id	int	Container ID.
.. name	string	Name of the container.
.. is_active	bool	Active status of the container.
product	object	Details about the ordered product.
.. name_id	string	Name ID of the product. See Glossary – Product identifiers
.. name	string	Display name of the product. See Glossary – Product identifiers
.. type	string	Product type. See Glossary – Product types
.. validation_type	string	Validation type used by the product. See Glossary – Validation types
.. validation_name	string	Display name of the validation type.
.. validation_description	string	Description of the validation type.
.. csr_required	bool	Specifies if a CSR is required for the product type.
organization_contact	object	Details about the organization contact on the order. See Structures – Contact details object.
technical_contact	object	Details about the technical contact on the order. See Structures – Contact details object.
user	object	Details about the user that submitted the order. See Structures – User details object.
purchased_dns_names	int	Number of additional SANs purchased.
requests	array	List of objects containing details about the order request.
.. .. id	int
.. .. date	string
.. .. type	string
.. .. status	string
.. .. comments	string
receipt_id	int	Receipt ID.
cs_provisioning_method	string	For document and EV code signing orders, specifies the method by which the token will be sent. See Glossary – CS provisioning methods
public_id	string	ID used for express installations.
allow_duplicates	bool	Specifies if the order allows duplicate certificates.
user_assignments		List of users that created or have been assigned to the order. See Structures – User details object.
is_out_of_contract	bool	Contract status of the order.
payment_method	string	Payment method used for the order. Possible values: `balance` (account balance), `credit` (credit card), `profile` (account default payment)
product_name_id	string	Name ID of the product. See Glossary – Product identifiers
custom_fields	array	List of custom field data.
.. metadata_id	int	Custom field metadata ID.
.. label	string	Name of the custom field.
.. value	string	Entered value for the custom field.
disable_issuance_email	bool	Specifies if issuance emails are sent.
disable_ct	bool	Specifies if the certificate will be logged in public CT logs.
api_key	object	Specifies if the order was requested via Services API or ACME. Omitted if order was requested via another method (e.g., CertCentral account, Guest Request URL, etc.).
.. name	string	Name of the API key or ACME Directory URL.
.. key_type	string	Key type used for the request. Possible values: `api_key` (API), `acme_url` (ACME)

* - Returned only for issued certificate orders.

Response parameters

À propos de