訂單資訊

GET

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

您可以用憑證的指紋或序號取代 {{order_id}}，以取得指定憑證訂單的資訊。

使用此端點取得憑證訂單的詳細資料。

從組織聯絡人複製技術聯絡人資料。

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
}

回應參數

名稱	類型	說明
id	int	訂單 ID。
certificate	object	與憑證有關的詳細資料。
.. id	int	憑證 ID。
.. thumbprint	string	憑證的指紋。
.. serial_number *	string	憑證的序號。
.. common_name	string	由憑證保護安全的名稱。
.. emails	array	與憑證關聯的電郵的清單。
.. dns_names	array	由憑證保護安全的其他名稱的清單。
.. date_created	string	建立憑證時的時間戳記。格式：UTC 時區和 ISO 8601 日期
.. valid_from *	string	憑證有效期限開始日期。格式：`yyyy-MM-dd`
.. valid_till *	string	憑證到期日。格式：`yyyy-MM-dd`
.. days_remaining	int	將來憑證到期天數。
.. csr	string	憑證簽章要求。
.. organization	object	憑證上的組織。
.. .. id	int	組織 ID。
.. organization_units	array	憑證上的組織單位的清單。
.. server_platform	object	與伺服器平台有關的詳細資料。
.. .. id	int	伺服器平台 ID。請參閱詞彙 — 伺服器平台
.. .. name	string	伺服器平台的名稱。
.. .. install_url	string	憑證安裝指示的 URL。
.. .. csr_url	string	CSR 產生指示的 URL。
.. signature_hash	string	憑證使用的簽章演算法。
.. key_size	int	金鑰中使用的位元數。
.. ca_cert	object	用於簽署憑證的 Certificate authority (憑證授權機關，CA) 憑證。
.. .. id	string	CA 憑證 ID。
.. .. name	string	CA 的名稱。
status	string	訂單的狀態。請參閱詞彙 — 訂單狀態
is_renewal	bool	說明訂單是否續訂。
is_renewed	bool	說明訂單是否已續訂。
renewed_order_id	int	之前訂單的訂單 ID。僅在訂單續訂時傳回。
date_created	string	訂單建立日期。格式：UTC 時區和 ISO 8601 日期
organization	object	與訂單關聯的組織有關的詳細資料。
.. id	int	組織 ID。
.. name	string	組織的法律名稱。
.. assumed_name	string	組織的公用名稱。也稱為 DBA 名稱。
.. display_name	string	組織的完整名稱。使用名稱 + assumed_name 建構。
.. city	string	組織所位於的城市。
.. state	string	組織所位於的省。
.. country	string	組織所位於的國家。
validity_years	string	憑證將有效的年數。
disable_renewal_notifications	bool	說明是否啟用續訂通知。
auto_renew	int	說明是否啟用自動續訂。可能的值：`0` (停用)，`1` (啟用)
container	object	與訂單關聯的容器有關的詳細資料。
.. id	int	容器 ID。
.. name	string	容器的名稱。
.. is_active	bool	容器的啟用狀態。
product	object	與訂購的產品有關的詳細資料。
.. name_id	string	產品的名稱 ID。請參閱詞彙 — 產品識別碼
.. name	string	顯示產品名稱。請參閱詞彙 — 產品識別碼
.. type	string	產品類型。請參閱詞彙 — 產品類型
.. validation_type	string	產品使用的驗證類型。請參閱詞彙 — 驗證類型
.. validation_name	string	驗證類型的顯示名稱。
.. validation_description	string	驗證類型的說明。
.. csr_required	bool	說明產品類型是否需要 CSR。
organization_contact	object	與訂單的組織聯絡人有關的詳細資料。請參閱結構 — 聯絡人詳細資料物件。
technical_contact	object	與訂單的技術聯絡人有關的詳細資料。請參閱結構 — 聯絡人詳細資料物件。
user	object	與提交訂單的使用者有關的詳細資料。請參閱結構 — 使用者詳細資料物件。
purchased_dns_names	int	購買的其他 SAN 數目。
requests	array	包含與訂單要求有關的詳細資料的物件的清單。
.. .. id	int
.. .. date	string
.. .. type	string
.. .. status	string
.. .. comments	string
receipt_id	int	收據 ID。
cs_provisioning_method	string	關於文件和 EV 代碼簽章訂單，請依照傳送出去的權杖指定方法。請參閱詞彙 — CS 建置方法
public_id	string	使用於快速安裝的 ID。
allow_duplicates	bool	說明訂單是否允許重複的憑證。
user_assignments		建立或已指派給訂單的使用者的清單。請參閱結構 — 使用者詳細資料物件。
is_out_of_contract	bool	訂單的合約狀態。
payment_method	string	訂單使用的付款方法。可能的值：`balance` (帳戶餘額)、`credit`(信用卡)、`profile`(帳戶預設付款)
product_name_id	string	產品的名稱 ID。請參閱詞彙 — 產品識別碼
custom_fields	array	自訂欄位資料的清單。
.. metadata_id	int	自訂欄位中繼資料 ID，
.. label	string	自訂欄位的名稱。
.. value	string	自訂欄位的輸入值。
disable_issuance_email	bool	說明是否傳出發行的電郵。
disable_ct	bool	說明此憑證是否將記錄在公用 CT 記錄中。
api_key	object	說明是否透過 Services API 或 ACME 要求訂單。若訂單是透過其他方法 (例如 CertCentral 帳戶、訪客要求 URL 等) 要求時省略。
.. name	string	API 金鑰或 ACME Directory URL 的名稱。
.. key_type	string	用於要求的金鑰類型。可能的值：`api_key` (API)、 `acme_url` (ACME)

* - 僅傳回已發行的憑證訂單。

回應參數

關於