DCV 방법 변경

PUT
https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/method

Use this endpoint to set the domain control validation (DCV) method for a domain.

DCV emails

By default, changing the DCV method to email from any other method automatically sends DCV emails to the email addresses returned in the validation_emails array.

  • To change the DCV method to email without sending any DCV emails, set the value of the send_dcv_email_flag request parameter to false in your JSON payload.
  • If the domain is already configured to use email as the DCV method, submitting email as the DCV method does not cause new DCV emails to be sent. To resend DCV emails, use the Resend DCV email endpoint.

Example requests and responses

cURL
curl -X PUT \
  'https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/method' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
	"dcv_method": "<dcv_method>"
}'
Python
import requests

url = "https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/method"

payload = "{\n\t\"dcv_method\": \"<dcv_method>\"\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("PUT", 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/{{domain_id}}/dcv/method"

	payload := strings.NewReader("{\n\t\"dcv_method\": \"<dcv_method>\"\n}")

	req, _ := http.NewRequest("PUT", 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: 'PUT',
  url: 'https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/method',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: { dcv_method: '<dcv_method>' },
  json: true };

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

  console.log(body);
});
200 OK (email)
{
  "validation_emails": {
    "name_scope": "example.net",
    "base_emails": [
      "webmaster@example.net",
      "administrator@example.net",
      "postmaster@example.net",
      "admin@example.net",
      "hostmaster@example.net"
    ]
  }
}
200 OK (dns-cname-token)
{
    "dcv_token": {
        "token": "<random_value>",
        "status": "pending",
        "expiration_date": "2018-11-18T20:35:32+00:00",
        "verification_value": "dcv.digicert.com"
    }
}
200 OK (http-token)
{
    "dcv_token": {
        "token": "<random_value>",
        "status": "pending",
        "expiration_date": "2018-11-18T20:38:45+00:00",
        "http_token_url": "http://example.com/.well-known/pki-validation/<random_file_name>.txt"
    }
}
200 OK (dns-txt-token)
{
    "dcv_token": {
        "token": "<random_value>",
        "status": "pending",
        "expiration_date": "2018-11-18T20:40:43+00:00"
    }
}
200 (no change)
// Submitting the same dcv_method already set for the domain returns an empty JSON object
{}

Path parameters

Name Req/Opt Description
domain_id required Domain ID.

Request parameters

Name Req/Opt Type Description
dcv_method required string DCV method to use for the domain.
Allowed values: See Glossary – DCV methods
locale optional string Locale code for the language of the DCV emails. Ignored if dcv_method is not email.
Allowed values: See Glossary – Locale codes.
Default: If the request does not include a valid locale code, we send the DCV emails in English.
send_dcv_email_flag optional boolean If true (default) and you change the dcv_method to email from any other method, DigiCert automatically sends DCV emails to the email addresses returned in the validation_emails array. Otherwise, false.
If the domain is already configured to use email as the DCV method, passing true for the send_dcv_email_flag parameter does not cause new DCV emails to be sent. To resend DCV emails, use the Resend DCV email endpoint.

Response parameters

Submitting the same dcv_method already set for the domain returns an empty JSON object: {}

Name Type Description
validation_emails object Email addresses used when sending DCV emails. Only returned when changing the DCV method to email.
.. name_scope string Domain scope used for WHOIS record and constructed email addresses.
.. base_emails array List of constructed email addresses.
.. whois_emails array List of email addresses on WHOIS record.
dcv_token string Object containing information about the DCV method change.
.. token string Random value used to prove control over domain.
.. status string Status of the domain verification.
.. expiration_date string Timestamp of when the DCV token will expire.
Format: UTC timezone and ISO 8601 date
.. verification_value string Value for the DNS record target host field
Only returned if DCV method is dns-cname-token.
.. http_token_url string Filename and location for the .txt file.
Only returned if DCV method is http-token.