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)

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.

Antragsparameter

Reaktionsparameter

Über