도메인 추가

POST
https://www.digicert.com/services/v2/domain

이 엔드포인트를 사용하여 도메인을 추가하고 조직과 연결합니다.

도메인에 대해 최소 한 개의 유효성 검사를 지정해야 합니다. 사용 가능한 유효성 검사 유형을 받으려면 유효성 검사 유형 받기 엔드포인트를 사용합니다.

cURL
curl -X POST \
  https://www.digicert.com/services/v2/domain \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "name": "example.com",
    "organization": {
        "id": 112233
    },
    "validations": [
        {
            "type": "ov"
        },
        {
        	"type": "ev"
        }
    ],
    "dcv_method": "email"
}'
Python
import requests

url = "https://www.digicert.com/services/v2/domain"

payload = "{\n    \"name\": \"example.com\",\n    \"organization\": {\n        \"id\": 112233\n    },\n    \"validations\": [\n        {\n            \"type\": \"ov\"\n        },\n        {\n        \t\"type\": \"ev\"\n        }\n    ],\n    \"dcv_method\": \"email\"\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/domain"

	payload := strings.NewReader("{\n    \"name\": \"example.com\",\n    \"organization\": {\n        \"id\": 112233\n    },\n    \"validations\": [\n        {\n            \"type\": \"ov\"\n        },\n        {\n        \t\"type\": \"ev\"\n        }\n    ],\n    \"dcv_method\": \"email\"\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/domain',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { name: 'example.com',
     organization: { id: 112233 },
     validations: [ { type: 'ov' }, { type: 'ev' } ],
     dcv_method: 'email' },
  json: true };

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

  console.log(body);
});
201 Created (email)
{
    "id": 123356,
    "validation_emails": {
        "name_scope": "example.com",
        "base_emails": [
            "postmaster@example.com",
            "administrator@example.com",
            "hostmaster@example.com",
            "admin@example.com",
            "webmaster@example.com"
        ],
        "whois_emails": [
            "it@example.com"
        ]
    }
}
201 Created (dns-txt-token)
{
    "id": 123356,
    "dcv_token": {
        "token": "{{random_token}}",
        "status": "pending",
        "expiration_date": "2019-03-02T17:21:39+00:00"
    }
}
201 Created (dns-cname-token)
{
    "id": 123356,
    "dcv_token": {
        "token": "{{random_token}}",
        "status": "pending",
        "expiration_date": "2019-03-02T17:22:05+00:00",
        "verification_value": "dcv.digicert.com"
    }
}
201 Created (http-token)
{
    "id": 671903,
    "dcv_token": {
        "token": "{{random_token}}",
        "status": "pending",
        "expiration_date": "2019-03-02T17:22:48+00:00",
        "http_token_url": "http://example.com/.well-known/pki-validation/{{random_filename}}.txt"
    }
}

요청 매개 변수

이름 필수/옵션 유형 설명
name 필수 string 제출할 도메인 이름입니다.
organization 필수 object 도메인의 조직입니다.
.. id 필수 int 조직 ID입니다.
validations 필수 array 도메인에 대한 유효성 검사 유형의 목록입니다.
.. type 필수 string 유효성 검사 유형 식별자입니다.
용어집 — 유효성 검사를 참조하십시오.
dcv_method 옵션 string 사용할 도메인 제어 유효성 검사 방법입니다.
용어집 — DCV 방법을 참조하십시오.

응답 매개 변수

이름 유형 설명
id int 추가한 도메인의 ID입니다.
validation_emails object DCV 이메일 보낼 때 사용하는 이메일 주소입니다.
email DCV 방법에 대해서만 반환됩니다.
.. name_scope string WHOIS 레코드 및 구성된 이메일 주소에 대해 사용하는 도메인 범위입니다.
.. base_emails array 구성된 이메일 주소의 목록입니다.
.. whois_emails array WHOIS 레코드에 이메일 주소의 목록입니다.
dcv_token object DCV 토큰 상세 정보입니다.
dns-txt-token 및, dns-cname-token, http-token DCV 방법에 대해서만 반환됩니다.
.. token string DCV 방법에서 사용하는 임의 값입니다.
.. status string DCV 상태입니다.
가능한 값: pending, active
.. expiration_date string 토큰이 만료될 때에 대한 타임스탬프입니다.
형식: UTC 표준 시간대 ISO 8601 날짜
.. http_token_url string 텍스트 파일의 파일 이름 및 웹 서버에 위치할 곳입니다.
http-token DCV 방법에 대해서만 반환됩니다.