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.
Use esta URL base ao construir solicitações de API:
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.
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.
https://www.digicert.com/services/v2/user?container_id=123&limit=10
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.
A API de serviços da DigiCert usa estes métodos padrão HTTP:
GET
POST
PUT
HEAD
DELETE
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 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.
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"
}'
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)
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))
}
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);
});
{
"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"
}
}
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}}'
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)
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))
}
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);
});
{
"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"
}
}
]
}
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}}'
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)
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))
}
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);
});
// empty