Unterkonto erstellen

POST
https://www.digicert.com/services/v2/account

Falls Ihr Kundenbetreuer keine Unterkonten zugelassen hat, erhalten Sie einen access_denied|missing_permission-Fehler.

Verwenden Sie diesen Endpunkt, um ein neues Unterkonto zu erstellen.

Beim Erstellen eines verwalteten Kontos, wird der API-Schlüssel nur dieses eine Mal im api_key-Parameter der Antwort gezeigt. Er wird nie wieder angezeigt werden, und es gibt keinen Weg, ihn wiederherzustellen, wenn er verloren geht.

cURL
curl -X POST \
  https://www.digicert.com/services/v2/account \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "account_type": "retail",
  "allowed_grandchildren": [
    "retail",
    "enterprise",
    "reseller"
  ],
  "account_manager_user_id": 12345,
  "user": {
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@example.com",
    "username": "john.smith@example.com",
    "job_title": "Statistician",
    "telephone": "111-222-333-4444"
  },
  "organization": {
    "name": "Example Company, LLC",
    "address": "123 Fake Street",
    "address2": "Suite 321",
    "zip": "93090",
    "city": "Toledo",
    "state": "AL",
    "country": "US",
    "telephone": "111-222-333-4445"
  }
}'
Python
import requests

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

payload = "{\n  \"account_type\": \"retail\",\n  \"allowed_grandchildren\": [\n    \"retail\",\n    \"enterprise\",\n    \"reseller\"\n  ],\n  \"account_manager_user_id\": 12345,\n  \"user\": {\n    \"first_name\": \"John\",\n    \"last_name\": \"Smith\",\n    \"email\": \"john.smith@example.com\",\n    \"username\": \"john.smith@example.com\",\n    \"job_title\": \"Statistician\",\n    \"telephone\": \"111-222-333-4444\"\n  },\n  \"organization\": {\n    \"name\": \"Example Company, LLC\",\n    \"address\": \"123 Fake Street\",\n    \"address2\": \"Suite 321\",\n    \"zip\": \"93090\",\n    \"city\": \"Toledo\",\n    \"state\": \"AL\",\n    \"country\": \"US\",\n    \"telephone\": \"111-222-333-4445\"\n  }\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/account"

	payload := strings.NewReader("{\n  \"account_type\": \"retail\",\n  \"allowed_grandchildren\": [\n    \"retail\",\n    \"enterprise\",\n    \"reseller\"\n  ],\n  \"account_manager_user_id\": 12345,\n  \"user\": {\n    \"first_name\": \"John\",\n    \"last_name\": \"Smith\",\n    \"email\": \"john.smith@example.com\",\n    \"username\": \"john.smith@example.com\",\n    \"job_title\": \"Statistician\",\n    \"telephone\": \"111-222-333-4444\"\n  },\n  \"organization\": {\n    \"name\": \"Example Company, LLC\",\n    \"address\": \"123 Fake Street\",\n    \"address2\": \"Suite 321\",\n    \"zip\": \"93090\",\n    \"city\": \"Toledo\",\n    \"state\": \"AL\",\n    \"country\": \"US\",\n    \"telephone\": \"111-222-333-4445\"\n  }\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/account',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { account_type: 'retail',
     allowed_grandchildren: [ 'retail', 'enterprise', 'reseller' ],
     account_manager_user_id: 12345,
     user: 
      { first_name: 'John',
        last_name: 'Smith',
        email: 'john.smith@example.com',
        username: 'john.smith@example.com',
        job_title: 'Statistician',
        telephone: '111-222-333-4444' },
     organization: 
      { name: 'Example Company, LLC',
        address: '123 Fake Street',
        address2: 'Suite 321',
        zip: '93090',
        city: 'Toledo',
        state: 'AL',
        country: 'US',
        telephone: '111-222-333-4445' } },
  json: true };

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

  console.log(body);
});
201 Created
{
  "id": 1122334,
  "account_type": "retail",
  "account_manager_user_id": 12345,
  "organization": {
    "id": 3344556,
    "status": "active",
    "name": "Example Company, LLC",
    "display_name": "Example Company, LLC",
    "is_active": true,
    "address": "123 Fake Street",
    "zip": "93090",
    "city": "Toledo",
    "state": "AL",
    "country": "us",
    "telephone": "111-222-333-4445",
    "container": {
      "id": 112234,
      "parent_id": 0,
      "name": "Example Company, LLC",
      "is_active": true
    }
  },
  "user": {
    "id": 45321,
    "username": "john.smith@example.com",
    "account_id": 12121,
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@example.com",
    "job_title": "Statistician",
    "telephone": "111-222-333-4444",
    "type": "standard"
  }
}
201 Created (managed subaccount)
{
  "id": 1122334,
  "account_type": "managed",
  "account_manager_user_id": 12345,
  "organization": {
    "id": 3344556,
    "status": "active",
    "name": "Example Company, LLC",
    "display_name": "Example Company, LLC",
    "is_active": true,
    "address": "123 Fake Street",
    "zip": "93090",
    "city": "Toledo",
    "state": "AL",
    "country": "us",
    "telephone": "111-222-333-4445",
    "container": {
      "id": 112234,
      "parent_id": 0,
      "name": "Example Company, LLC",
      "is_active": true
    }
  },
  "user": {
    "id": 45321,
    "username": "john.smith@example.com",
    "account_id": 12121,
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@example.com",
    "job_title": "Statistician",
    "telephone": "111-222-333-4444",
    "type": "standard"
  },
  "api_key": "{{api_key}}"
}

Antragsparameter

Name Antr./Opt. Typ Beschreibung
account_type erforderlich string Der Typ des zu erstellenden Unterkontos
Siehe Glossar – Unterkontotypen
Zulässige Werte: standard, enterprise, reseller, managed
allowed_grandchildren erforderlich array Liste der Kontotypen, die unter dem Konto erstellt werden können
Siehe Glossar – Unterkontotypen
Zulässige Werte: standard, enterprise, reseller
account_manager_user_id optional int ID eines vorhandenen Benutzer, der das Unterkonto verwaltet
bill_parent optional bool Sollen alle Zertifikatsaufträge dem übergeordneten Konto in Rechnung gestellt werden?
Standard: false
user erforderlich object Details über den neu zu erstellenden Benutzer des Unterkontos
.. first_name erforderlich string Vorname des Unterkontobenutzers
.. last_name erforderlich string Nachname des Unterkontobenutzers
.. email erforderlich string E-Mail-Adresse des Unterkontobenutzers
Die E-Mail zur Kontoeinrichtung wird an diese Adresse gesendet.
.. username optional string Benutzername für die Anmeldung bei dem Unterkonto
Falls er fehlt, wird die email als Benutzername verwendet.
.. job_title optional string Funktion des Unterkontobenutzers
.. telephone optional string Telefonnummer des Unterkontobenutzers
organization erforderlich object Details über die primäre Organisation des Unterkontos
.. name erforderlich string Rechtlicher Name der Organisation
.. assumed_name optional string Öffentlicher Name der Organisation
Auch bekannt als DBA-Name
.. address erforderlich string Adresse der Organisation
.. address2 optional string
.. zip erforderlich string Postleitzahl der Organisation
.. city erforderlich string Stadt, in der sich die Organisation befindet
.. state erforderlich string Bundesland, in dem sich die Organisation befindet
.. country erforderlich string Land, in dem sich die Organisation befindet
.. telephone optional string Telefonnummer der Organisation

Reaktionsparameter

Name Typ Beschreibung
id int Kostenstellen-ID für das Unterkonto
account_type string Konto Typ des Unterkonto
account_manager_user_id int Benutzer-ID des Unterkontoverwalters
bill_parent bool Sollen die Zertifikatsaufträge dem übergeordneten Konto in Rechnung gestellt werden?
organization object Details über die primäre Organisation des Unterkontos
.. id int Organisations-ID
.. status string Organisationsstatus
Mögliche Werte: active, inactive
.. name string Rechtlicher Name der Organisation
.. assumed_name string Öffentlicher Name der Organisation
Auch bekannt als DBA-Name
.. display_name string Voller Name der Organisation
Konstruiert anhand des Namens + assumed_name.
.. is_active bool Aktiver Status der Organisation.
.. address string Adresse der Organisation
.. address2 string
.. zip string Postleitzahl der Organisation
.. city string Stadt, in der sich die Organisation befindet
.. state string Bundesland, in dem sich die Organisation befindet
.. country string Land, in dem sich die Organisation befindet
.. telephone string Telefonnummer der Organisation
.. container object Der primäre Container der Organisation ist angeheftet an.
.. .. id int Container-ID
.. .. parent_id int ID des übergeordneten Containers
.. .. name string Name des Containers
.. .. is_active bool Aktiver Status der Organisation.
user object Details über den neuen Benutzer des Unterkontos
.. id int Benutzer-ID.
.. username string Benutzername für die Anmeldung bei dem Unterkonto
.. account_id int Kostenstellen-ID für das neue Unterkonto
.. first_name string Vorname des Benutzers.
.. last_name string Nachname des Benutzers.
.. email string E-Mail-Adresse des Benutzers.
.. job_title string Funktion des Benutzers.
.. telephone string Telefonnummer des Benutzers.
.. type string Benutzertyp.
Mögliche Werte: standard
api_key string Generierter API-Schlüssel für das Unterkonto
Wird nur zurückgegeben, falls subaccount_type managed ist.