訂購 GeoTrust DV SSL

POST
https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex

使用此端點要求 GeoTrust DV SSL 憑證。

GeoTrust DV SSL 憑證越有使用彈性,越容易使 GeoTrust DV 憑證符合您的需求。此憑證取代 GeoTrust Standard DV、GeoTrust Cloud DV 和 GeoTrust Wildcard DV 產品。

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex' \
  -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/ssl_dv_geotrust_flex"

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)
Go
package main

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

func main() {

	url := "https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex"

	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/ssl_dv_geotrust_flex',
  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 201 Created (email)
{
  "id": 6484932,
  "certificate_id": 6079436
}
201 201 Created (dns-txt-toke 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.
允許的值取代: 12
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 說明要使用的付款方法。
允許的值: balancecardprofile
預設: 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 方法時傳回。