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 -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 | 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 |
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.
|