Créer une commande d'unités

POST
https://www.digicert.com/services/v2/units/order

Appelez ce point de terminaison pour créer une commande d'unités. Les commandes d'unités vous permettent d'acheter des unités pour les sous-comptes que vous gérez.

Pour acheter des unités pour un sous-compte, la méthode de tarification pour le sous-compte doit être paramétrée sur units. Pour obtenir la méthode de tarification d’un sous-compte, appelez le point de terminaisonRépertorier les produits d'un sous-compte.

Pour créer une commande d'unités, l’option permettant d'autoriser les transferts d'unités doit être activée pour votre compte. Pour savoir si cette option est activée pour votre compte, contactez votre gestionnaire de compte.

Exemples de requêtes et de réponses

cURL
curl --request POST 'https://www.digicert.com/services/v2/units/order' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "unit_account_id": {{unit_account_id}},
    "notes": "Notes about the order",
    "bundle": [
        {
            "product_name_id": "ssl_securesite_flex",
            "units": "5"
        },
		{
            "product_name_id": "ssl_ev_securesite_flex",
            "units": "20"
        }
    ]
}'
Python
import requests

url = "https://www.digicert.com/services/v2/units/order"

payload = "{\n    \"unit_account_id\": {{unit_account_id}},\n    \"notes\": \"For Testing Purpose\",\n    \"bundle\": [\n        {\n            \"product_name_id\": \"ssl_securesite_flex\",\n            \"units\": \"5\"\n        },\n\t\t{\n            \"product_name_id\": \"ssl_ev_securesite_flex\",\n            \"units\": \"20\"\n        }\n    ]\n}"
headers = {
  'X-DC-DEVKEY': {{api_key}},
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
Go
package main

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

func main() {

		url := "https://www.digicert.com/services/v2/units/order"
		method := "POST"

		payload := strings.NewReader("{\n    \"unit_account_id\": {{unit_account_id}},\n    \"notes\": \"For Testing Purpose\",\n    \"bundle\": [\n        {\n            \"product_name_id\": \"ssl_securesite_flex\",\n            \"units\": \"5\"\n        },\n		{\n            \"product_name_id\": \"ssl_ev_securesite_flex\",\n            \"units\": \"20\"\n        }\n    ]\n}")

		client := &http.Client {
		}
		req, err := http.NewRequest(method, url, payload)

		if err != nil {
				fmt.Println(err)
		}
		req.Header.Add("X-DC-DEVKEY", {{api_key}})
		req.Header.Add("Content-Type", "application/json")

		res, err := client.Do(req)
		defer res.Body.Close()
		body, err := ioutil.ReadAll(res.Body)

		fmt.Println(string(body))
}
NodeJS
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://www.digicert.com/services/v2/units/order',
  'headers': {
    'X-DC-DEVKEY': {{api_key}},
    'Content-Type': 'application/json'
  },
  body: "{\n    \"unit_account_id\": {{unit_account_id}},\n    \"notes\": \"For Testing Purpose\",\n    \"bundle\": [\n        {\n            \"product_name_id\": \"ssl_securesite_flex\",\n            \"units\": \"5\"\n        },\n\t\t{\n            \"product_name_id\": \"ssl_ev_securesite_flex\",\n            \"units\": \"20\"\n        }\n    ]\n}"

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
201 Created
{
  "id": 1371
}

Paramètres de demande

Nom Obligatoire/facultatif Type Description
unit_account_id Obligatoire integer Identifiant du sous-compte pour lequel acheter des unités.
Pour obtenir les identifiants des sous-comptes sous votre responsabilité, appelez le point de terminaison Répertorier les sous-comptes.
notes Facultatif string Note personnalisée à joindre à la commande.
Limite de nombre de caractères : 512
bundle Obligatoire array Liste d'un ou plusieurs objets contenant les informations sur la quantité d'unités à commander pour chaque type de produit.
.. product_name_id Obligatoire string Identificateur unique pour le produit pour lequel vous souhaitez commander des unités.
Valeurs autorisées : Consultez le Glossaire — Identificateurs de produits.
.. units Obligatoire integer Quantité d'unités à commander pour le produit spécifié.

Paramètres de réponse

Nom Type Description
id integer ID de la commande