Agregar dominio

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

Use este terminal para agregar un dominio y asociarlo con una organización.

Debe especificar, al menos, un tipo de validación para el dominio. Use el terminal Obtener tipo de validación para obtener los tipos de validación 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"
    }
}

Parámetros de la solicitud

Nombre Solicitud/opción Tipo Descripción
name obligatorio string Nombre de dominio para enviar
organization obligatorio object La organización del dominio.
.. id obligatorio int Id. de organización.
validations obligatorio array Lista de tipos de validación para el dominio.
.. type obligatorio string Identificador del tipo de validación.
Vea Glosario: tipos de validación
dcv_method opcional string Método de validación de control de dominio para usar.
Vea Glosario: método DCV

Parámetros de la respuesta

Nombre Tipo Descripción
id int Id. del dominio agregado.
validation_emails object Direcciones de correo electrónico usadas al enviar los correos electrónicos DCV.
Solo se devuelven para el método DCV email.
.. name_scope string Alcance del dominio que se usa para el registro WHOIS y las direcciones de correo electrónico formadas.
.. base_emails array Lista de direcciones de correo electrónico formadas.
.. whois_emails array Lista de direcciones de correo electrónico que figuran en el registro WHOIS.
dcv_token object Detalles del autentificador DCV.
Solo se devuelve para los métodos DCV dns-txt-token, dns-cname-token, y http-token.
.. token string Valor aleatorio que se usará para la validación DCV.
.. status string Estado DCV.
Posibles valores: pending, active
.. expiration_date string Marca de tiempos de cuándo caduca el autentificador.
Formato: Zona horaria UTC y fecha de ISO 8601
.. http_token_url string Nombre de archivo del archivo de texto y dónde debería colocarse en el servidor web.
Solo se devuelven para el método DCV http-token.