Pedido OV/EV SSL

POST
https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}

Esta página descreve produtos com o nome de grupo ssl_certificate (consulte Glossário — Identificadores de produtos).

Use este ponto de extremidade para enviar um pedido de solicitação de certificado OV/EV usando ssl_plus, ssl_multi_domain, ssl_wildcard, ssl_ev_plus, ssl_ev_multi_domain, ou ssl_cloud_wildcard como a ssl_certificate_id.

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "example.com",
        "dns_names": [
            "sub.example.com",
            "app.example.com"
        ],
        "csr": "<csr>",
        "server_platform": {
            "id": 45
        },
        "signature_hash": "sha256",
        "organization_units": [
            "Accounting department"
        ]
    },
    "validity_years": 2,
    "comments": "Message for the approver",
    "disable_renewal_notifications": true,
    "locale": "en",
    "payment_method": "balance",
    "skip_approval": true,
    "organization": {
        "id": 123456
    },
    "custom_fields": [
        {
            "metadata_id": 11,
            "value": "Invoice #00001"
        }
    ]
}'
Python
import requests

url = "https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}"

payload = "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n            \"sub.example.com\",\n            \"app.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 45\n        },\n        \"signature_hash\": \"sha256\",\n        \"organization_units\": [\n            \"Accounting department\"\n        ]\n    },\n    \"validity_years\": 2,\n    \"comments\": \"Message for the approver\",\n    \"disable_renewal_notifications\": true,\n    \"locale\": \"en\",\n    \"payment_method\": \"balance\",\n    \"skip_approval\": true,\n    \"organization\": {\n        \"id\": 123456\n    },\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 11,\n            \"value\": \"Invoice #00001\"\n        }\n    ]\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/order/certificate/{{ssl_certificate_id}}"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n            \"sub.example.com\",\n            \"app.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 45\n        },\n        \"signature_hash\": \"sha256\",\n        \"organization_units\": [\n            \"Accounting department\"\n        ]\n    },\n    \"validity_years\": 2,\n    \"comments\": \"Message for the approver\",\n    \"disable_renewal_notifications\": true,\n   \"locale\": \"en\",\n    \"payment_method\": \"balance\",\n    \"skip_approval\": true,\n    \"organization\": {\n        \"id\": 123456\n    },\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 11,\n            \"value\": \"Invoice #00001\"\n        }\n    ]\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/order/certificate/{{ssl_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'example.com',
        dns_names: [ 'sub.example.com', 'app.example.com' ],
        csr: '<csr>',
        server_platform: { id: 45 },
        signature_hash: 'sha256',
        organization_units: [ 'Accounting department' ] },
     validity_years: 2,
     comments: 'Message for the approver',
     disable_renewal_notifications: true,
     locale: 'en',
     payment_method: 'balance',
     skip_approval: true,
     organization: { id: 123456 },
     custom_fields: [ { metadata_id: 11, value: 'Invoice #00001' } ] },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
201 (one-step)
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "pending"
    }
  ]
}
201 (two-step)
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "submitted"
    }
  ]
}
201 (auto)
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "approved"
    }
  ],
  "certificate_id": 113
}
201 (skip)
{
  "id": 112233,
  "certificate_id": 113
}
201 (immediate)
{
  "id": 112233,
  "certificate_id": 113,
  "certificate_chain": [
    {
      "subject_common_name": "example.com",
      "pem": "<pem_certificate>"
    },
    {
      "subject_common_name": "DigiCert SHA2 Secure Server CA",
      "pem": "<pem_certificate>"
    },
    {
      "subject_common_name": "DigiCert Global Root CA",
      "pem": "<pem_certificate>"
    }
  ]
}

Parâmetros da solicitação

Para informações sobre valores permitidos para campos do certificado, consulte Certificados publicamente confiáveis – Entradas de dados que violam os padrões na indústria.

Nome Obr/Opc Tipo Descrição
certificate obrigatório object Detalhes do certificado.
.. common_name obrigatório string Domínio a ser protegido.
.. dns_names opcional array Domínios adicionais a serem protegidos.
Pode resultar em custos adicionais. (Consulte Melhores práticas — Obter ambas versões de um domínio gratuitamente.)
.. csr obrigatório string Solicitação de Assinatura de Certificado (CSR).
.. signature_hash obrigatório string Algoritmo de hash usado para assinar o certificado.
Certificados SSL/TLS suportam apenas SHA-256.
.. organization_units opcional array Departamento na sua organização para o certificado.
.. server_platform opcional object Tipo da plataforma do servidor.
Padrão: -1 (outro)
.. .. id obrigatório int ID da plataforma do servidor.
Veja Glossário — Plataformas do servidor
.. profile_option opcional string Se usando perfis de certificados personalizados, especifique o nome do perfil.
renewed_thumbprint opcional string Se o pedido for uma renovação, insira a impressão digital SHA-1 do certificado primário do pedido anterior.
validity_years obrigatório int Número de anos que o certificado é válido.
Pode ser substituído por validity_days ou custom_expiration_date.
Valores permitidos: 1, 2
validity_days opcional int Número de dias que o certificado é válido após emissão.
Substitui validity_years
custom_expiration_date opcional string Data de vencimento personalizada para o certificado. Data deve ser menor que 825 dias no futuro.
Substitui validity_days e validity_years
Formato: yyyy-MM-dd
comments opcional string Comentários sobre o pedido para o aprovador.
auto_renew opcional int Especifica se o certificado deve renovar automaticamente.
Padrão: 0
Valores permitidos: 0 (desabilitado), 1 (habilitado)
custom_renewal_message opcional string Mensagem personalizada a ser incluída em notificações de renovação.
disable_renewal_notifications opcional bool Especifica se e-mails de notificação de renovação devem ser desabilitados.
Padrão: false
additional_emails opcional array Endereços adicionais de e-mail recebem e-mails de notificação (por ex., emissão do certificado, certificado duplicado, renovações de certificados, etc.).
renewal_of_order_id opcional int Se o pedido for uma renovação, insira a ID do pedido anterior.
payment_method opcional string Especifique o método de pagamento a usar.
Valores permitidos: balance, card, profile
Padrão: balance
dcv_method opcional string Método DCV a usar ao verificar o controle do domínio.
Consulte Glossário — Métodos DCV
skip_approval  opcional bool Especifica se o pedido deve pular a etapa de aprovação e ser imediatamente enviado para validação e emitido quando concluído.
Padrão: false
disable_ct opcional bool Especifica se registro de CT para o certificado deve ser desabilitado.
Registro de CT específico ao pedido deve ser habilitado ou isso será ignorado. Consulte Permitir que usuários mantenham certificados fora de registros de CT.
Padrão: false
organization obrigatório object Recipiente para detalhes da organização.
.. id obrigatório int ID da organização para associar com o pedido.
De outra forma, é possível passar um objeto da organização para adicionar uma nova organização ao enviar um pedido. Veja Criar organização para requisitos de estrutura do objeto.
.. contacts obrigatório array Lista de contatos da organização para o pedido.
Nota:
  • Para pedidos OV, é possível omitir esta matriz para usar o contato padrão para a organização especificada.
  • Para pedidos EV, é necessário incluir um contato ev_approver. Para obter possíveis aprovadores EV, veja Listar aprovadores.
.. .. contact_type obrigatório string Tipo de contato para adicionar ao pedido.
Valores permitidos: organization_contact, technical_contact, ev_approver
.. .. user_id obrigatório* int ID do usuário existente ou contato para a conta.
* Pode ser omitido se adicionando um novo contato.
.. .. first_name opcional string Primeiro nome do novo contato.
Nota: Obrigatório ao omitir user_id. Se user_id não estiver omitido, as informações do usuário especificado serão atualizadas com o novo valor.
.. .. last_name opcional string Sobrenome do novo contato.
Nota: Obrigatório ao omitir user_id. Se user_id não estiver omitido, as informações do usuário especificado serão atualizadas com o novo valor.
.. .. job_title opcional string Cargo de trabalho do novo contato.
Nota: Obrigatório ao omitir user_id. Se user_id não estiver omitido, as informações do usuário especificado serão atualizadas com o novo valor.
.. .. telephone opcional string Número de telefone do novo contato.
Nota: Obrigatório ao omitir user_id. Se user_id não estiver omitido, as informações do usuário especificado serão atualizadas com o novo valor.
.. .. email opcional string Endereço de e-mail do novo contato.
Nota: Obrigatório ao omitir user_id. Se user_id não estiver omitido, as informações do usuário especificado serão atualizadas com o novo valor.
container opcional object Se necessário, especifique o recipiente em que o pedido deve ser colocado.
.. id obrigatório int ID do recipiente.
custom_fields opcional* array Campos personalizados específicos à conta.
*Se esses campos são obrigatórios ou não dependerá das suas configurações de campos personalizados.
.. metadata_id obrigatório int ID do campo personalizado.
.. value obrigatório string Valor para o campo personalizado.
Tipo de validação de dados depende das suas configurações de campos personalizados.

Parâmetros da resposta

Nome Tipo Descrição
id int ID do pedido.
organization object Recipiente para novos detalhes da organização.
Retornado apenas se uma nova organização foi criada com o pedido.
.. id int ID da organização para a nova organização.
requests array Possui informações sobre a solicitação.
.. id int ID da solicitação.
.. status string Status da solicitação.
Valores possíveis: pending, submitted, approved, rejected
certificate_id int ID do Certificado.
Retornado se o status da solicitação for approved.