組織を作成

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)

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.

Example requests and responses

Request parameters

Response parameters

案内