Создать субучетную запись

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

Если представитель вашей учетной записи не активировал субучетные записи, вы получите сообщение об ошибке access_denied|missing_permission.

Используйте эту конечную точку для создания новой субучетной записи.

При создании управляемой учетной записи ключ API отображается один раз в параметре api_key тела ответа. Он никогда не будет показан вновь, и не существует никаких способов его восстановления в случае потери.

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}}"
}

Параметры запроса

Имя Обязательный/Необязательный Тип Описание
account_type обязательный string Укажите тип создаваемой субучетной записи.
См. Словарь — Типы субучетных записей
Допустимые значения: standard, enterprise, reseller, managed
allowed_grandchildren обязательный array Список типов учетных записей, которые могут быть созданы в рамках учетной записи.
См. Словарь — Типы субучетных записей
Допустимые значения: standard, enterprise, reseller
account_manager_user_id необязательный int Идентификатор существующего пользователя, который будет управлять субучетной записью.
bill_parent необязательный bool Укажите, следует ли направлять счета на оплату в родительскую учетную запись по всем заказам на сертификаты.
По умолчанию: false
user обязательный object Подробная информация о вновь создаваемом пользователе субучетной записи.
.. first_name обязательный string Имя пользователя субучетной записи.
.. last_name обязательный string Фамилия пользователя субучетной записи.
.. email обязательный string Адрес электронной почты пользователя субучетной записи.
На этот адрес будет отправлено электронное письмо о создании учетной записи.
.. username необязательный string Имя пользователя используется для входа в субучетную запись.
Если пропускается, значение email будет использоваться в качестве имени пользователя.
.. job_title необязательный string Название должности пользователя субучетной записи.
.. telephone необязательный string Номер телефона пользователя субучетной записи.
organization обязательный object Подробная информация о первичной организации субучетной записи
.. name обязательный string Юридическое название организации.
.. assumed_name необязательный string Публичное название организации.
Также называется именем DBA.
.. address обязательный string Адрес организации.
.. address2 необязательный string
.. zip обязательный string Почтовый индекс организации.
.. city обязательный string Город, в котором находится организация.
.. state обязательный string Штат, в котором находится организация.
.. country обязательный string Страна, в которой находится организация.
.. telephone необязательный string Номер телефона организации.

Параметры ответного сообщения

Имя Тип Описание
id int Идентификатор субучетной записи.
account_type string Тип субучетной записи.
account_manager_user_id int Пользовательский идентификатор менеджера субучетной записи.
bill_parent bool Указывает, направляются ли счета на оплату в родительскую учетную запись заказам на сертификаты.
organization object Подробная информация о первичной организации субучетной записи.
.. id int Идентификатор организации.
.. status string Статус организации.
Допустимые значения: active, inactive
.. name string Юридическое название организации.
.. assumed_name string Публичное название организации.
Также называется именем DBA.
.. display_name string Полное название организации.
Создано с использованием имени + assumed_name.
.. is_active bool Активный статус организации.
.. address string Адрес организации.
.. address2 string
.. zip string Почтовый индекс организации.
.. city string Город, в котором находится организация.
.. state string Штат, в котором находится организация.
.. country string Страна, в которой находится организация.
.. telephone string Номер телефона организации.
.. container object Основной контейнер, к которому прикреплена организация.
.. .. id int Идентификатор контейнера.
.. .. parent_id int Идентификатор прямого предка контейнера.
.. .. name string Имя контейнера.
.. .. is_active bool Активный статус организации.
user object Подробная информация о новом пользователе субучетной записи.
.. id int ИД пользователя.
.. username string Имя пользователя используется для входа в субучетную запись.
.. account_id int Идентификатор новой субучетной записи.
.. first_name string Имя пользователя.
.. last_name string Фамилия пользователя.
.. email string Адрес электронной почты пользователя.
.. job_title string Название должности пользователя.
.. telephone string Номер телефона пользователя.
.. type string Тип пользователя.
Допустимые значения: standard
api_key string Сгенерированный ключ API для субучетной записи.
Указывается в ответе, только если subaccount_typemanaged.