Ajouter un domaine

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

Exécutez ce point de terminaison pour ajouter un domaine et l’associer à une organisation.

Vous devez spécifier au moins un type de validation pour le domaine. Exécutez les point de terminaison Get validation types pour obtenir les types de validation disponibles.

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

Paramètres de demande

Nom Obligatoire/facultatif Type Description
name Obligatoire string Nom de domaine à envoyer
organization Obligatoire object L’organisation du domaine
.. id Obligatoire int ID de l’organisation
validations Obligatoire array Liste des types de validation pour le domaine
.. type Obligatoire string Identificateur du type de validation
Consultez le Glossaire — Types de validation
dcv_method Facultatif string Méthode de validation du contrôle de domaine à utiliser.
Consultez le Glossaire — Méthodes DCV

Paramètres de réponse

Nom Type Description
id int ID du domaine ajouté.
validation_emails object Adresse électronique utilisée pour envoyer les courriers DCV
Renvoyée seulement pour la méthode DCV email.
.. name_scope string Étendue de domaine utilisée pour l’enregistrement WHOIS et les adresses électroniques construites
.. base_emails array Liste des adresses électroniques construites
.. whois_emails array Liste des adresses électroniques figurant sur l’enregistrement WHOIS
dcv_token object Détails du jeton DCV
Seulement renvoyé pour les méthodes DCV dns-txt-token, dns-cname-token, et http-token.
.. token string Valeur aléatoire à utiliser pour la validation DCV
.. status string Statut DCV
Valeurs possibles : pending, active
.. expiration_date string Horodatage de l’expiration du jeton
Format : Fuseau horaire UTC et date ISO 8601
.. http_token_url string Nom du fichier texte et emplacement où il devrait figurer sur le serveur web
Renvoyée seulement pour la méthode DCV http-token.