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)

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`.

Parametri richiesta

Parametri di risposta

Informazioni