订购 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 如果订单是续订订单,请输入上一个订单的编号。
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 订单编号。
certificate_id int 证书编号。
dcv_random_value string 用于验证域控制权的随机值。
仅当使用 dns-txt-token 或 http-token 作为 DCV 方法时返回。