Ordina certificato di firma documento

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

Questa pagina descrive i prodotti con il nome gruppo document_signing (consulta Glossario – Identificatori prodotto).

Usa questo endpoint per inviare un ordine di richiesta certificato di firma documento usando document_signing_org_1 o document_signing_org_2 come document_certificate_id.

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{document_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "server_platform": {
            "id": 21
        },
        "signature_hash": "sha256"
    },
    "cs_provisioning_method": "ship_token",
    "use_org_as_common_name": true,
    "validity_years": 2,
    "comments": "Comments for the the approver.",
    "organization": {
        "id": 334455
    },
    "container": {
        "id": 221122
    },
    "ship_info": {
        "name": "Erin Guerra",
        "addr1": "360 Taylor Street",
        "addr2": "Floor 74",
        "city": "Richmond",
        "state": "va",
        "zip": "69662",
        "country": "us",
        "method": "standard"
    },
    "subject": {
        "name": "Rene Pierce",
        "job_title": "School Counselor",
        "phone": "054-139-0798",
        "email": "rene.pierce@yahoo.com"
    },
    "csa_agreed_to": 1,
    "skip_approval": true,
    "payment_method": "balance"
}'
Python
import requests

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

payload = "{\n    \"certificate\": {\n        \"server_platform\": {\n            \"id\": 21\n        },\n        \"signature_hash\": \"sha256\"\n    },\n    \"cs_provisioning_method\": \"ship_token\",\n    \"use_org_as_common_name\": true,\n    \"validity_years\": 2,\n    \"comments\": \"Comments for the the approver.\",\n    \"organization\": {\n        \"id\": 334455\n    },\n    \"container\": {\n        \"id\": 221122\n    },\n    \"ship_info\": {\n        \"name\": \"Erin Guerra\",\n        \"addr1\": \"360 Taylor Street\",\n        \"addr2\": \"Floor 74\",\n        \"city\": \"Richmond\",\n        \"state\": \"va\",\n        \"zip\": \"69662\",\n        \"country\": \"us\",\n        \"method\": \"standard\"\n    },\n    \"subject\": {\n        \"name\": \"Rene Pierce\",\n        \"job_title\": \"School Counselor\",\n        \"phone\": \"054-139-0798\",\n        \"email\": \"rene.pierce@yahoo.com\"\n    },\n    \"csa_agreed_to\": 1,\n    \"skip_approval\": true,\n    \"payment_method\": \"balance\"\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/{{document_certificate_id}}"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"server_platform\": {\n            \"id\": 21\n        },\n        \"signature_hash\": \"sha256\"\n    },\n    \"cs_provisioning_method\": \"ship_token\",\n    \"use_org_as_common_name\": true,\n    \"validity_years\": 2,\n    \"comments\": \"Comments for the the approver.\",\n    \"organization\": {\n        \"id\": 334455\n    },\n    \"container\": {\n        \"id\": 221122\n    },\n    \"ship_info\": {\n        \"name\": \"Erin Guerra\",\n        \"addr1\": \"360 Taylor Street\",\n        \"addr2\": \"Floor 74\",\n        \"city\": \"Richmond\",\n        \"state\": \"va\",\n        \"zip\": \"69662\",\n        \"country\": \"us\",\n        \"method\": \"standard\"\n    },\n    \"subject\": {\n        \"name\": \"Rene Pierce\",\n        \"job_title\": \"School Counselor\",\n        \"phone\": \"054-139-0798\",\n        \"email\": \"rene.pierce@yahoo.com\"\n    },\n    \"csa_agreed_to\": 1,\n    \"skip_approval\": true,\n    \"payment_method\": \"balance\"\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/{{document_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: { server_platform: { id: 21 }, signature_hash: 'sha256' },
     cs_provisioning_method: 'ship_token',
     use_org_as_common_name: true,
     validity_years: 2,
     comments: 'Comments for the the approver.',
     organization: { id: 334455 },
     container: { id: 221122 },
     ship_info: 
      { name: 'Erin Guerra',
        addr1: '360 Taylor Street',
        addr2: 'Floor 74',
        city: 'Richmond',
        state: 'va',
        zip: '69662',
        country: 'us',
        method: 'standard' },
     subject: 
      { name: 'Rene Pierce',
        job_title: 'School Counselor',
        phone: '054-139-0798',
        email: 'rene.pierce@yahoo.com' },
     csa_agreed_to: 1,
     skip_approval: true,
     payment_method: 'balance' },
  json: true };

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

  console.log(body);
});
201 Created (one-step approval)
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "pending"
        }
    ]
}
201 Created (two-step approval)
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "submitted"
        }
    ]
}
201 Created
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "approved"
        }
    ],
    "certificate_id": 113
}

Parametri richiesta

Nome Rich/Opz Tipo Descrizione
certificate obbligatorio object Dettagli certificato.
.. csr facoltativo* string Richiesta di firma certificato (CSR).
*Richiesto se cs_provisioning_method è email.
.. server_platform facoltativo object Tipo di piattaforma server.
Predefinita: -1 (altro)
.. .. id obbligatorio int ID piattaforma server.
Consulta Glossario — Piatteforme server
.. signature_hash obbligatorio string Algoritmo hash usato per firmare il certificato.
Valori consentiti: sha256
cs_provisioning_method facoltativo string Specifica come vuoi ricevere il token.
Consulta Glossario — Metodi di provisioning CS
use_org_as_common_name facoltativo bool Specifica se il nome organizzazione deve essere usato come nome comune riportato sul certificato.
Predefinita: true
validity_years obbligatorio int Numero di anni in cui è valido il certificato.
Valori consentiti: 1, 2, 3
comments facoltativo string Commenti sull’ordine per l’approvatore.
organization obbligatorio object Organizzazione da associare all’ordine.
.. id obbligatorio int ID organizzazione.
container facoltativo object Se necessario, specificare il contenitore in cui deve essere posizionato l’ordine.
.. id obbligatorio int ID contenitore.
ship_info facoltativo object Specifica l’indirizzo di spedizione per il token.
.. name obbligatorio stringa
.. addr1 obbligatorio stringa
.. addr2 facoltativo stringa
.. city obbligatorio stringa
.. state obbligatorio stringa
.. zip obbligatorio stringa
.. country obbligatorio stringa
.. method obbligatorio string Priorità di spedizione per il token.
Valori consentiti: standard, expedited (sono previsti costi aggiuntivi)
subject obbligatorio object Informazioni soggetto per il certificato.
.. name obbligatorio string Nome completo del soggetto.
.. job_title obbligatorio string Qualifica soggetto.
.. phone obbligatorio string Numero di telefono soggetto.
.. email obbligatorio string Indirizzo e-mail soggetto.
custom_fields facoltativo* object Campi personalizzati specifici dell’account.
*L’obbligatorietà di questi campi dipende dalle impostazioni dei campi personalizzati.
.. metadata_id obbligatorio int ID campo personalizzato.
.. value obbligatorio string Valore per il campo personalizzato.
Il tipo di convalida dati dipende dalle impostazioni dei campi personalizzati.
user_id_assignments facoltativo array Elenco degli ID utente che possono gestire l’ordine.
skip_approval facoltativo bool Specifica se l’ordine deve saltare la fase di approvazione ed essere inviato immediatamente per la convalida ed emesso se completato.
Predefinita: false
payment_method facoltativo string Specifica il metodo di pagamento da usare.
Valori consentiti: balance, card, profile
Predefinita: balance

Parametri di risposta

Nome Tipo Descrizione
id int ID ordine.
organization object Contenitore per i nuovi dettagli organizzazione.
Riportato solo se è stata creata una nuova organizzazione con l’ordine.
.. id int ID organizzazione per la nuova organizzazione.
requests array Contiene le informazioni sulla richiesta.
.. id int ID richiesta
.. status string Stato richiesta.
Valori possibili: pending, submitted, approved, rejected
certificate_id int ID certificato.
Riportato se lo stato richiesta. è approved.