하위 계정 만들기

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 하위 계정을 관리할 기존 사용자의 ID입니다.
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 하위 계정의 계정 ID입니다.
account_type string 하위 계정의 계정 유형입니다.
account_manager_user_id int 하위 계정 고객 담당 관리자의 사용자 ID입니다.
bill_parent bool 상위 계정에 인증서 주문에 대해 청구해야 하는지 지정합니다.
organization object 하위 계정의 주요 조직에 대한 상세 정보입니다.
.. id int 조직 ID입니다.
.. 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 컨테이너 ID입니다.
.. .. parent_id int 컨테이너의 부모의 ID입니다.
.. .. name string 컨테이너의 이름입니다.
.. .. is_active bool 조직 활성 상태입니다.
user object 새 하위 계정 사용자에 대한 상세 정보입니다.
.. id int 사용자 ID입니다.
.. username string 하위 계정에 로그인하기 위해 사용하는 사용자 이름입니다.
.. account_id int 새 하위 계정의 계정 ID입니다.
.. first_name string 사용자의 이름(성 제외)입니다.
.. last_name string 사용자의 성입니다.
.. email string 사용자의 이메일 주소입니다.
.. job_title string 사용자의 직함입니다.
.. telephone string 사용자의 전화 번호입니다.
.. type string 사용자 유형입니다.
가능한 값: standard
api_key string 하위 계정에 대한 생성된 API 키입니다.
subaccount_type이(가) managed인 경우에만 반환됩니다.