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)

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.

Antragsparameter

Reaktionsparameter

Über