Aggiungi dominio

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

Usa questo endpoint per aggiungere un dominio e associarlo ad un’organizzazione.

Devi specificare almeno un tipo di convalida per il dominio. Usa l’endpoint Richiedi tipi di convalida per ottenere i tipi di convalida disponibili.

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

Parametri richiesta

Nome Rich/Opz Tipo Descrizione
name obbligatorio string Nome dominio da inviare
organization obbligatorio object L’organizzazione del dominio.
.. id obbligatorio int ID organizzazione.
validations obbligatorio array Elenco dei tipi di convalida per il dominio.
.. type obbligatorio string Identificatore tipo di convalida.
Consulta Glossario — Tipi di convalida
dcv_method facoltativo string Metodo di convalida controllo dominio da usare.
Consulta Glossario — Metodi DCV

Parametri di risposta

Nome Tipo Descrizione
id int ID del dominio aggiunto.
validation_emails object Indirizzi e-mail usati quando si inviano delle e-mail DCV.
Riportati solo per il metodo DCV email.
.. name_scope string Ambito del dominio usato per il record WHOIS e gli indirizzi e-mail costruiti.
.. base_emails array Elenco degli indirizzi e-mail costruiti.
.. whois_emails array Elenco degli indirizzi e-mail sul record WHOIS.
dcv_token object Dettagli del token DCV.
Riportati solo per i metodi DCV dns-txt-token, dns-cname-token, e http-token.
.. token string Valore causale da usare per la convalida DCV.
.. status string Stato DCV.
Valori possibili: pending, active
.. expiration_date string Indicazione di data e ora di quando scade il token.
Formato: Fuso orario UTC e data ISO 8601
.. http_token_url string Nome file del file di testo e posizione in cui deve essere posizionato sul server web.
Riportati solo per il metodo DCV http-token.