訂單資訊

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)
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
}

回應參數

名稱 類型 說明
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)

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

關於

DigiCert is the world's leading provider of scalable TLS/SSL, IoT and PKI solutions for identity and encryption. The most innovative companies, including 89% of the Fortune 500 and 97 of the 100 top global banks, choose DigiCert for its expertise in identity and encryption for web servers and Internet of Things devices. DigiCert supports TLS and other digital certificates for PKI deployments at any scale through its certificate lifecycle management solution, CertCentral®. The company is recognized for its enterprise-grade certificate management platform, fast and knowledgeable customer support, and market-leading security solutions. For the latest DigiCert news and updates, visit digicert.com or follow @digicert.

©2020 DigiCert, Inc. All rights reserved. DigiCert, its logo and CertCentral are registered trademarks of DigiCert, Inc. Norton and the Checkmark Logo are trademarks of NortonLifeLock Inc. used under license. Other names may be trademarks of their respective owners.