조직 만들기

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

Use this endpoint to create a new organization.

When you use this endpoint, we check the organizations that already exist in your account to avoid creating a duplicate organization. If the details you provide in the request match the details of an existing organization, we associate the order with the existing organization instead of creating a new one. To override this behavior and force the request to create a new organization, set the organization.skip_duplicate_org_check parameter to true in the body of your request.

Submitted organization information will be validated by DigiCert and may appear on certificates.

Example requests and responses

cURL
curl -X POST \
  https://www.digicert.com/services/v2/organization \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "name": "Epigyne Unwieldiness llc",
    "assumed_name": "Epigyne Unwieldiness",
    "country": "us",
    "address": "932 Prospect Street",
    "address2": "Floor 08",
    "city": "Minneapolis",
    "state": "Minnesota",
    "zip": "40849",
    "telephone": "666-186-6450",
    "organization_contact": {
        "first_name": "Gia",
        "last_name": "Booth",
        "job_title": "Clinical Laboratory Technician",
        "email": "gia.booth@inbox.com",
        "telephone": "666-186-6450",
        "telephone_extension": "736"
    }
}'
Python
import requests

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

payload = "{\n    \"name\": \"Epigyne Unwieldiness llc\",\n    \"assumed_name\": \"Epigyne Unwieldiness\",\n    \"country\": \"us\",\n    \"address\": \"932 Prospect Street\",\n    \"address2\": \"Floor 08\",\n    \"city\": \"Minneapolis\",\n    \"state\": \"Minnesota\",\n    \"zip\": \"40849\",\n    \"telephone\": \"666-186-6450\",\n    \"organization_contact\": {\n        \"first_name\": \"Gia\",\n        \"last_name\": \"Booth\",\n        \"job_title\": \"Clinical Laboratory Technician\",\n        \"email\": \"gia.booth@inbox.com\",\n        \"telephone\": \"666-186-6450\",\n        \"telephone_extension\": \"736\"\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/organization"

	payload := strings.NewReader("{\n    \"name\": \"Epigyne Unwieldiness llc\",\n    \"assumed_name\": \"Epigyne Unwieldiness\",\n    \"country\": \"us\",\n    \"address\": \"932 Prospect Street\",\n    \"address2\": \"Floor 08\",\n    \"city\": \"Minneapolis\",\n    \"state\": \"Minnesota\",\n    \"zip\": \"40849\",\n    \"telephone\": \"666-186-6450\",\n   
 \"organization_contact\": {\n        \"first_name\": \"Gia\",\n        \"last_name\": \"Booth\",\n        \"job_title\": \"Clinical Laboratory Technician\",\n        \"email\": \"gia.booth@inbox.com\",\n        \"telephone\": \"666-186-6450\",\n        \"telephone_extension\": \"736\"\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/organization',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { name: 'Epigyne Unwieldiness llc',
     assumed_name: 'Epigyne Unwieldiness',
     country: 'us',
     address: '932 Prospect Street',
     address2: 'Floor 08',
     city: 'Minneapolis',
     state: 'Minnesota',
     zip: '40849',
     telephone: '666-186-6450',
     organization_contact: 
      { first_name: 'Gia',
        last_name: 'Booth',
        job_title: 'Clinical Laboratory Technician',
        email: 'gia.booth@inbox.com',
        telephone: '666-186-6450',
        telephone_extension: '736' } },
  json: true };

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

  console.log(body);
});
201 Created
{
  "id": 112236
}

Request parameters

Name Req/Opt Type Description
name required string Legal name of the organization.
Character limit: 64 if assumed_name is empty or not provided. If the request includes an assumed_name value, the combined length of the submitted name + assumed_name values cannot exceed 61 characters. Three characters are reserved for spacing and punctuation.
assumed_name optional string Public name of the organization.
Also called Doing Business As (DBA) name.
Character limit: The combined length of the submitted name + assumed_name values cannot exceed 61 characters. Three characters are reserved for spacing and punctuation.
country required string Two-letter country code for the country where the organization is located.
Format: Must be a valid ISO 3166-1 alpha-2 code.
address required string Address of the organization.
Character limit: 64
address2 optional string Second line of the organization's address.
Character limit: 64
city required string City where the organization is located.
Character limit: 64
state required string State or province where the organization is located. Use the full name instead of an abbreviation.
Character limit: 64
zip required string Postal code of the organization.
Character limit: 40
telephone required string Organization telephone number.
Character limit: 32
organization_contact required object Object with information about the organization contact.
.. first_name required string First name of the contact.
Character limit: 128
.. last_name required string Last name of the contact.
Character limit: 128
.. job_title conditional string Job title of the contact. Required for the contact to be an EV approver.
Character limit: 64
.. email required string Email address that can be used to reach contact.
Character limit: 255
.. telephone conditional string Telephone number that can be used to reach the contact. Required for contact to be an EV approver.
Character limit: 32
.. telephone_extension optional string Phone extension of the contact.
Character limit: 16
skip_duplicate_org_check optional boolean Use true to skip the check for duplicate organizations in your account. When you skip this check, you force the request to create a new organization, regardless of whether the details you provide in the request match the details of an organization that already exists in your account.
Default: false

Response parameters

Name Type Description
id integer ID of the new organization.