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'))

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.