訂單資訊

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)

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