도메인 추가

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)

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 방법에 대해서만 반환됩니다.

요청 매개 변수

응답 매개 변수

정보