Auftrag für Einheiten erstellen

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

Verwenden Sie diesen Endpunkt, um einen Auftrag für Einheiten zu erstellen. Mit Aufträgen für Einheiten können Sie Einheiten für die von Ihnen verwalteten Unterkonten kaufen.

Um Einheiten für ein Unterkonto zu kaufen, muss die Preisfindungsmethode für das Unterkonto auf units gesetzt sein. Um die Preisfindungsmethode für ein Unterkonto zu erhalten, verwenden Sie den Endpunkt Unterkonto-Produkte auflisten.

Um einen Auftrag für Einheiten zu erstellen, muss die Option zum Zulassen der Übertragung von Einheiten für Ihr Konto aktiviert sein. Um herauszufinden, ob diese Option für Ihr Konto aktiviert ist, wenden Sie sich an Ihren Kundenbetreuer.

Beispielabfragen und -antworten

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
}

Antragsparameter

Name Antr./Opt. Typ Beschreibung
unit_account_id erforderlich integer ID des Unterkontos, für das Einheiten gekauft werden sollen.
Um IDs für die von Ihnen verwalteten Unterkonten abzurufen, verwenden Sie den Endpunkt Unterkonten auflisten.
notes optional string Benutzerdefinierte Notiz zum Anhängen an den Auftrag.
Zeichenbegrenzung: 512
bundle erforderlich array Liste von einem oder mehreren Objekten mit Informationen über die Menge der zu bestellenden Einheiten für jeden Produkttyp.
.. product_name_id erforderlich string Eindeutiger Bezeichner für das Produkt, für das Sie Einheiten bestellen möchten.
Erlaubte Werte: Siehe Glossar – Produktbezeichner.
.. units erforderlich integer Menge der zu bestellenden Einheiten für das angegebene Produkt.

Reaktionsparameter

Name Typ Beschreibung
id integer ID des Auftrags.