API de serviços

A API de serviços da DigiCert é uma API poderosa que lhe permite automatizar processos típicos de certificados para poupar tempo e simplificar a gestão de certificados. A API de serviços usa convenções RESTful modernas e é simples de usar.

Por que usá-la?

  • Acesse todos os recursos disponíveis na CertCentral sem precisar fazer login na plataforma.
  • Personalize e automatize virtualmente qualquer fluxo de trabalho dentro da plataforma de gestão de certificados.
  • Crie sua própria versão da plataforma com a identidade visual da sua organização.
  • Integração fácil com as suas ferramentas existentes.

URL Base

Use esta URL base ao construir solicitações de API:

bash
https://www.digicert.com/services/v2

Cada página do ponto de extremidade fornece apenas a última parte da URL do ponto de extremidade (por ex., /pedidos). Certifique-se de preceder a URL base ao ponto de extremidade ao construir solicitações.

Cadeias de consulta de URL

Alguns pontos de extremidade usam cadeias de consulta de URL para filtrar resultados. Cadeias de consulta de URL são precedidas à URL do ponto de extremidade usando ?, com cadeias de consulta de URL precedidas usando &.

Este exemplo usa a cadeia de consulta container_id para filtrar resultados ao recipiente especificado. Ele também usa a cadeia de consulta limit para retornar apenas dez resultados.

bash
https://www.digicert.com/services/v2/user?container_id=123&limit=10

Solicitações

Todas as solicitações de API são enviadas através de URLs RESTful usando recursos REST, incluindo autenticação baseada em cabeçalho e tipos de solicitação JSON/XML.

A codificação para conjuntos de caracteres de dados para solicitações é UTF-8. Uma solicitação bem preparada usa porta 443 e tem os cabeçalhos de agente usuário e comprimento do conteúdo especificados.

Método

A API de serviços da DigiCert usa estes métodos padrão HTTP:

  • GET
  • POST
  • PUT
  • HEAD
  • DELETE

Corpo

Grande parte das solicitações exige passar dados formatados JSON ou XML. Se um ponto de extremidade suporta ou exige um formato diferente, ele será observado para tal ponto de extremidade.

Valores suportados do tipo de conteúdo incluem:

  • application/json
  • application/xml
  • image/jpeg
  • image/png

Respostas

Respostas contemplam cabeçalhos e um corpo. O corpo é formato com base no tipo de conteúdo especificado na solicitação.

Veja Glossário – Cabeçalhos para informações sobre códigos de respostas do cabeçalho HTTP.

Exemplos

Adicionar uma nota a um pedido

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/note' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "text": "This is a note"
}'
Python
import requests

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

payload = "{\n\t\"text\": \"This is a note\"\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/xml"
    }

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/{{order_id}}/note"

	payload := strings.NewReader("{\n\t\"text\": \"This is a note\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/xml")

	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/{{order_id}}/note',
  headers: 
   { 'Content-Type': 'application/xml',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: '{\n\t"text": "This is a note"\n}' };

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

  console.log(body);
});
201 Created
{  
   "id": 1,
   "date_created": "2018-09-26T20:29:09+00:00",
   "text": "This is a note",
   "user": {  
      "id": 125039,
      "first_name": "John",
      "last_name": "Smith",
      "email": "john.smith@digicert.com"
   }
}

Recuperar todas notas sobre um pedido

cURL
curl -X GET \
  'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/note' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
Python
import requests

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

headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/xml"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
Go
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/xml")

	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: 'GET',
  url: 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/note',
  headers: 
   { 'Content-Type': 'application/xml',
     'X-DC-DEVKEY': '{{api_key}}' } };

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

  console.log(body);
});
200 OK
{  
   "notes": [  
      {  
         "id": 1,
         "date_created": "2018-09-26T20:29:09+00:00",
         "text": "This is a note",
         "user": {  
            "id": 125039,
            "first_name": "John",
            "last_name": "Smith",
            "email": "john.smith@digicert.com"
         }
      }
   ]
}

Excluir uma nota sobre um pedido

cURL
curl -X DELETE \
  'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/note/{{note_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
Python
import requests

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

headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/xml"
    }

response = requests.request("DELETE", url, headers=headers)

print(response.text)
Go
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

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

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/xml")

	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: 'DELETE',
  url: 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/note/{{note_id}}',
  headers: 
   { 'Content-Type': 'application/xml',
     'X-DC-DEVKEY': '{{api_key}}' } };

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

  console.log(body);
});
204 No Content
// empty