이 엔드포인트를 사용하여 도메인을 추가하고 조직과 연결합니다.
도메인에 대해 최소 한 개의 유효성 검사를 지정해야 합니다. 사용 가능한 유효성 검사 유형을 받으려면 유효성 검사 유형 받기 엔드포인트를 사용합니다.
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"
}'
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))
}
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);
});
{
"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"
]
}
}
{
"id": 123356,
"dcv_token": {
"token": "{{random_token}}",
"status": "pending",
"expiration_date": "2019-03-02T17:21:39+00:00"
}
}
{
"id": 123356,
"dcv_token": {
"token": "{{random_token}}",
"status": "pending",
"expiration_date": "2019-03-02T17:22:05+00:00",
"verification_value": "dcv.digicert.com"
}
}
{
"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 방법에 대해서만 반환됩니다.
|