Domäne hinzufügen

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

Verwenden Sie diesen Endpunkt, um eine Domäne hinzuzufügen und sie mit einer Organisation zu verknüpfen.

Sie müssen mindestens einen Validierungstyp für die Domäne angeben. Verwenden Sie den Endpunkt Validierungstypen abrufen, um verfügbare Validierungstypen zu erhalten.

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"
    }
}

Antragsparameter

Name Antr./Opt. Typ Beschreibung
name erforderlich string Zu übermittelnder Domänenname
organization erforderlich object Die Organisation der Domäne.
.. id erforderlich int Organisations-ID
validations erforderlich array Liste der Validierungstypen für die Domäne.
.. type erforderlich string Validierungstyp-ID:
Siehe Glossar – Validierungstypen
dcv_method optional string Die zu verwendende Methode zur Validierung der Domänenkontrolle.
Siehe Glossar – DCV-Methoden

Reaktionsparameter

Name Typ Beschreibung
id int ID der hinzugefügten Domäne.
validation_emails object Beim Senden von DCV-E-Mails verwendete E-Mail-Adressen.
Wird nur für die email-DCV-Methode zurückgegeben.
.. name_scope string Domänenbereich für den WHOIS-Eintrag und konstruierte E-Mail-Adressen.
.. base_emails array Liste der konstruierten E-Mail-Adressen.
.. whois_emails array Liste der E-Mail-Adressen im WHOIS-Eintrag.
dcv_token object DCV-Token-Details.
Wird nur zurückgegeben für die dns-txt-token, dns-cname-token, -DCV-Methode und die http-token-DCV-Methode.
.. token string Zufallswert für die DCV-Validierung.
.. status string DCV-Status.
Mögliche Werte: pending, active
.. expiration_date string Zeitstempel, wann der Token abläuft.
Format: UTC-Zeitzone und ISO 8601-Datum
.. http_token_url string Dateiname der Textdatei und wo sie auf dem Webserver platziert werden soll.
Wird nur für die http-token-DCV-Methode zurückgegeben.