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)

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

Parametri richiesta

Parametri di risposta

Informazioni