문서 서명 인증서 주문

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

이 페이지는 document_signing 그룹 이름이 있는 제품을 설명합니다.(용어집 — 제품 식별자를 참조하십시오.)

이 엔드포인트를 사용하여 document_signing_org_1 또는 document_signing_org_2을(를) document_certificate_id(으)로 사용하는 문서 서명 인증서 요청 주문을 제출합니다.

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{document_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "server_platform": {
            "id": 21
        },
        "signature_hash": "sha256"
    },
    "cs_provisioning_method": "ship_token",
    "use_org_as_common_name": true,
    "validity_years": 2,
    "comments": "Comments for the the approver.",
    "organization": {
        "id": 334455
    },
    "container": {
        "id": 221122
    },
    "ship_info": {
        "name": "Erin Guerra",
        "addr1": "360 Taylor Street",
        "addr2": "Floor 74",
        "city": "Richmond",
        "state": "va",
        "zip": "69662",
        "country": "us",
        "method": "standard"
    },
    "subject": {
        "name": "Rene Pierce",
        "job_title": "School Counselor",
        "phone": "054-139-0798",
        "email": "rene.pierce@yahoo.com"
    },
    "csa_agreed_to": 1,
    "skip_approval": true,
    "payment_method": "balance"
}'
Python
import requests

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

payload = "{\n    \"certificate\": {\n        \"server_platform\": {\n            \"id\": 21\n        },\n        \"signature_hash\": \"sha256\"\n    },\n    \"cs_provisioning_method\": \"ship_token\",\n    \"use_org_as_common_name\": true,\n    \"validity_years\": 2,\n    \"comments\": \"Comments for the the approver.\",\n    \"organization\": {\n        \"id\": 334455\n    },\n    \"container\": {\n        \"id\": 221122\n    },\n    \"ship_info\": {\n        \"name\": \"Erin Guerra\",\n        \"addr1\": \"360 Taylor Street\",\n        \"addr2\": \"Floor 74\",\n        \"city\": \"Richmond\",\n        \"state\": \"va\",\n        \"zip\": \"69662\",\n        \"country\": \"us\",\n        \"method\": \"standard\"\n    },\n    \"subject\": {\n        \"name\": \"Rene Pierce\",\n        \"job_title\": \"School Counselor\",\n        \"phone\": \"054-139-0798\",\n        \"email\": \"rene.pierce@yahoo.com\"\n    },\n    \"csa_agreed_to\": 1,\n    \"skip_approval\": true,\n    \"payment_method\": \"balance\"\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/{{document_certificate_id}}"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"server_platform\": {\n            \"id\": 21\n        },\n        \"signature_hash\": \"sha256\"\n    },\n    \"cs_provisioning_method\": \"ship_token\",\n    \"use_org_as_common_name\": true,\n    \"validity_years\": 2,\n    \"comments\": \"Comments for the the approver.\",\n    \"organization\": {\n        \"id\": 334455\n    },\n    \"container\": {\n        \"id\": 221122\n    },\n    \"ship_info\": {\n        \"name\": \"Erin Guerra\",\n        \"addr1\": \"360 Taylor Street\",\n        \"addr2\": \"Floor 74\",\n        \"city\": \"Richmond\",\n        \"state\": \"va\",\n        \"zip\": \"69662\",\n        \"country\": \"us\",\n        \"method\": \"standard\"\n    },\n    \"subject\": {\n        \"name\": \"Rene Pierce\",\n        \"job_title\": \"School Counselor\",\n        \"phone\": \"054-139-0798\",\n        \"email\": \"rene.pierce@yahoo.com\"\n    },\n    \"csa_agreed_to\": 1,\n    \"skip_approval\": true,\n    \"payment_method\": \"balance\"\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/{{document_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: { server_platform: { id: 21 }, signature_hash: 'sha256' },
     cs_provisioning_method: 'ship_token',
     use_org_as_common_name: true,
     validity_years: 2,
     comments: 'Comments for the the approver.',
     organization: { id: 334455 },
     container: { id: 221122 },
     ship_info: 
      { name: 'Erin Guerra',
        addr1: '360 Taylor Street',
        addr2: 'Floor 74',
        city: 'Richmond',
        state: 'va',
        zip: '69662',
        country: 'us',
        method: 'standard' },
     subject: 
      { name: 'Rene Pierce',
        job_title: 'School Counselor',
        phone: '054-139-0798',
        email: 'rene.pierce@yahoo.com' },
     csa_agreed_to: 1,
     skip_approval: true,
     payment_method: 'balance' },
  json: true };

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

  console.log(body);
});
201 Created (one-step approval)
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "pending"
        }
    ]
}
201 Created (two-step approval)
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "submitted"
        }
    ]
}
201 Created
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "approved"
        }
    ],
    "certificate_id": 113
}

요청 매개 변수

이름 필수/옵션 유형 설명
certificate 필수 object 인증서 상세 정보입니다.
.. csr 옵션* string CSR(인증서 서명 요청)
*cs_provisioning_method이(가) email인 경우 필수입니다.
.. server_platform 옵션 object 서버 플랫폼 유형입니다.
기본값: -1 (기타)
.. .. id 필수 int 서버 플랫폼 ID입니다.
용어집 — 서버 플랫폼을 참조하십시오.
.. signature_hash 필수 string 인증서를 서명하기 위해 사용되는 해시 알고리즘입니다.
허용되는 값: sha256
cs_provisioning_method 옵션 string 토큰을 받은 방식을 지정합니다.
용어집 — CS 프로비전 방법을 참조하십시오.
use_org_as_common_name 옵션 bool 조직 이름을 인증서에서 일반 이름으로 사용해야 하는지 지정합니다.
기본값: true
validity_years 필수 int 인증서가 유효한 연도의 수입니다.
허용되는 값: 1, 2, 3
comments 옵션 string 승인자에게 주문에 대한 설명입니다.
organization 필수 object 주문과 연결할 조직입니다.
.. id 필수 int 조직 ID입니다.
container 옵션 object 필요한 경우, 주문이 포함될 컨테이너를 지정합니다.
.. id 필수 int 컨테이너 ID입니다.
ship_info 옵션 object 토큰에 대한 배송지 주소를 지정합니다.
.. name 필수 string
.. addr1 필수 string
.. addr2 옵션 string
.. city 필수 string
.. state 필수 string
.. zip 필수 string
.. country 필수 string
.. method 필수 string 토큰의 배송 우선 순위입니다.
허용되는 값: standard, expedited (추가 비용 발생)
subject 필수 object 인증서에 대한 주체 정보입니다.
.. name 필수 string 주체의 전체 이름입니다.
.. job_title 필수 string 주체의 직함입니다.
.. phone 필수 string 주체 전화 번호입니다.
.. email 필수 string 주체 이메일 주소입니다.
custom_fields 옵션* object 계정별 사용자 지정 필드입니다.
*이 필드의 필요 여부는 사용자 지정 필드 설정에 따라 다릅니다.
.. metadata_id 필수 int 사용자 지정 필드 ID입니다.
.. value 필수 string 사용자 지정 필드에 대한 값입니다.
데이터 유효성 검사 유형은 사용자 지정 필드에 따라 다릅니다.
user_id_assignments 옵션 array 주문을 관리할 수 있는 사용자 ID의 목록입니다.
skip_approval 옵션 bool 주문이 승인 단계를 건너뛰어야 하며 즉시 유효성 검사에 제출하고 완료되면 발급해야 하는지 지정합니다.
기본값: false
payment_method 옵션 string 사용할 결제 방법을 지정합니다.
허용되는 값: balance, card, profile
기본값: balance

응답 매개 변수

이름 유형 설명
id int 주문 ID입니다.
organization object 새 조직 상세 정보에 대한 컨테이너입니다.
이 주문으로 새 조직이 만들어진 경우에만 반환됩니다.
.. id int 새 조직에 대한 조직 ID입니다.
requests array 요청에 대한 정보를 포함합니다.
.. id int 요청 ID입니다.
.. status string 요청 상태입니다.
가능한 값: pending, submitted, approved, rejected
certificate_id int 인증서 ID입니다.
요청 상태가 approved인 경우 반환됩니다.