訂購 DV SSL

POST

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

此頁面描述有 dv_ssl_certificate 群組名稱的產品 (請參閱詞彙 – 產品識別碼)。

使用此端點提交使用 ssl_dv_geotrust、,ssl_dv_rapidssl,wildcard_dv_geotrust,wildcard_dv_rapidssl,或 cloud_dv_geotrust 作為 dv_ssl_certificate_id 的 DV 憑證要求訂單。

cURL

curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{dv_ssl_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "example.com",
        "dns_names": [
        	"sub.example.com",
        	"log.example.com"
        ],
        "csr": "<csr>",
        "server_platform": {
            "id": 2
        }
    },
    "custom_expiration_date": "",
    "comments": "Message for the approver.",
    "container": {
        "id": 69748
    },
    "custom_renewal_message": "Renew me.",
    "skip_approval": true,
    "disable_ct": 0,
    "validity_years": 1,
    "custom_fields": [
        {
            "metadata_id": 12,
            "value": "Invoice #12345"
        }
    ],
    "payment_method": "balance",
    "dcv_method": "email",
    "dcv_emails": [
    	{
    		"dns_name": "example.com",
    		"email_domain": "example.com",
    		"email": "admin@example.com"
    	},
    	{
    		"dns_name": "sub.example.com",
    		"email_domain": "example.com",
    		"email": "jim.smith@example.com"
    	},
    	{
    		"dns_name": "log.example.com",
    		"email_domain": "example.com",
    		"email": "it@example.com"
    	}
    ],
    "locale": "en",
    "technical_contact": {
        "first_name": "Jim",
        "last_name": "Smith",
        "telephone": "555-555-5555",
        "job_title": "IT Admin",
        "email": "jim.smith@example.com"
    }
}'

Python

import requests

url = "https://www.digicert.com/services/v2/order/certificate/{{dv_ssl_certificate_id}}"

payload = "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\n    }\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/order/certificate/{{dv_ssl_certificate_id}}"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\n    }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	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: 'POST',
  url: 'https://www.digicert.com/services/v2/order/certificate/{{dv_ssl_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'example.com',
        dns_names: [ 'sub.example.com', 'log.example.com' ],
        csr: '<csr>',
        server_platform: { id: 2 } },
     custom_expiration_date: '',
     comments: 'Message for the approver.',
     container: { id: 69748 },
     custom_renewal_message: 'Renew me.',
     skip_approval: true,
     disable_ct: 0,
     validity_years: 1,
     custom_fields: [ { metadata_id: 12, value: 'Invoice #12345' } ],
     payment_method: 'balance',
     dcv_method: 'email',
     dcv_emails: 
      [ { dns_name: 'example.com',
          email_domain: 'example.com',
          email: 'admin@example.com' },
        { dns_name: 'sub.example.com',
          email_domain: 'example.com',
          email: 'jim.smith@example.com' },
        { dns_name: 'log.example.com',
          email_domain: 'example.com',
          email: 'it@example.com' } ],
     locale: 'en',
     technical_contact: 
      { first_name: 'Jim',
        last_name: 'Smith',
        telephone: '555-555-5555',
        job_title: 'IT Admin',
        email: 'jim.smith@example.com' } },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

201 Created (email)

{
  "id": 6484932,
  "certificate_id": 6079436
}

201 Created (dns-txt-token or http-token)

{
  "id": 6484932,
  "certificate_id": 6079436
  "dcv_random_value": "icru1984rnekfj"
}

要求參數

如需有關允許的憑證欄位值的資訊，請參閱公開受信任的憑證 – 違反業界標準的資料條目。

名稱	必填/選填	類型	說明
certificate	必填	object	憑證詳細資料。
.. common_name	必填	string	要保護安全的網域。
.. dns_names	選填	array	要保護安全的其他網域。可能產生其他成本。(請參閱最佳做法 — 免費取得兩個版本的網域。)
.. csr	必填^*	string	憑證簽章要求 (CSR)。
.. organization_units	選填	array	憑證針對的您的組織的部門。
.. server_platform	選填	object	伺服器平台類型。預設：`-1` (其他)
.. .. id	必填	int	伺服器平台 ID。請參閱詞彙 — 伺服器平台
renewed_thumbprint	選填	string	如果訂單是續訂的，請輸入之前訂單的主要憑證的 SHA-1 指紋。
validity_years	必填	int	憑證有效的年數。可以用 `validity_days` 或 `custom_expiration_date` 取代。允許的值：`1`,`2`
validity_days	選填	int	憑證發行後的有效天數。覆寫 `validity_years`
custom_expiration_date	選填	string	憑證的自訂到期日。日期不可早於將來的 825 天。覆寫 `validity_days` 和 `validity_years` 格式：`yyyy-MM-dd`
comments	選填	string	與核准者的訂單有關的註解。
auto_renew	選填	int	說明憑證是否應該自動續訂。預設：`0` 允許的值：`0` (停用)，`1` (啟用)
custom_renewal_message	選填	string	要納入續訂通知中的自訂訊息。
disable_renewal_notifications	選填	bool	說明是否應停用續訂通知電郵。預設：`false`
additional_emails	選填	array	接收憑證通知電郵的其他電郵地址 (例如憑證發行、重複憑證、憑證續訂等)。
renewal_of_order_id	選填	int	如果訂單是續訂的，請輸入之前訂單的 ID。
payment_method	選填	string	說明要使用的付款方法。允許的值：`balance`,`card`,`profile` 預設：`balance`
dcv_method	必填	string	確認網域控制權時使用的 DCV 方法。請參閱詞彙 — DCV 方法
dcv_emails	選填	array	列出傳送 DCV 電郵時的指定電郵範圍。您可以新增以憑證保護安全的每個 DNS 名稱的項目。
.. dns_name	必填	string	應套用此範圍的憑證上的 DNS 名稱。
.. email_domain	必填	string	要用於確認電郵地址的 WHOIS 網域記錄。此值必須與`dns_names`基本網域相符。
.. email	選填	string	傳送 DCV 電郵時使用的電郵地址。此電郵地址必須出現在 `email_domain` 參數中指定的網域的 WHOIS 記錄上。
locale	選填	string	DCV 電郵應使用的語言。請參閱詞彙 — 地區設定代碼
skip_approval	選填	bool	說明訂單是否應跳過核准步驟，並在完成時立刻提交進行驗證和發行。預設：`false`
disable_ct	選填	bool	說明是否應停用憑證的 CT 記錄。必須啟用特定訂單的 CT 記錄或將忽略此事項。請參閱允許使用者將憑證保存在 CT 記錄外。預設：`false`
container	選填	object	視需要說明在其之下下訂單的容器。
.. id	必填	int	容器 ID。
custom_fields	選填*	array	特定帳戶自訂欄位。 *是否需要這些欄位視您的自訂欄位設定而定。
.. metadata_id	必填	int	自訂欄位 ID。
.. value	必填	string	自訂欄位的值。資料驗證類型視您的自訂欄位設定而定。
technical_contact	選填	object	技術聯絡人詳細資料。
.. first_name	必填	string
.. last_name	必填	string
.. telephone	必填	string
.. job_title	選填	string
.. email	必填	string

回應參數

名稱	類型	說明
id	int	訂單 ID。
certificate_id	int	憑證 ID。
dcv_random_value	string	用於驗證網域控制權的隨機值。僅在使用 `dns-txt-token` 或 `http-token` 作為 DCV 方法時傳回。

要求參數

回應參數

關於