組織を一覧表示

GET

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

このエンドポイントを使用して、お使いのアカウントのすべての組織を一覧表示します。

ACCEPT ヘッダを text/csv に変更し、結果の CSV 出力を返します。

cURL

curl -X GET \
  https://www.digicert.com/services/v2/organization \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

Python

import requests

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

headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	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: 'GET',
  url: 'https://www.digicert.com/services/v2/organization',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' } };

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

  console.log(body);
});

200 OK

{
  "organizations": [
    {
      "id": 1,
      "status": "active",
      "name": "DigiCert Inc.",
      "display_name": "DigiCert Inc.",
      "is_active": true,
      "address": "2801 N Thanksgiving Way",
      "address2": "Suite 500",
      "zip": "84043",
      "city": "Lehi",
      "state": "Utah",
      "country": "us",
      "container": {
        "id": 4,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      }
    },
    {
      "id": 112233,
      "status": "active",
      "name": "Example Organization Inc.",
      "assumed_name": "Example Org",
      "display_name": "Example Organization",
      "is_active": true,
      "address": "123 Fake Stree",
      "address2": "Floor 55",
      "zip": "84043",
      "city": "Lehi",
      "state": "ut",
      "country": "us",
      "telephone": "801-701-9600",
      "container": {
        "id": 4,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      },
      "container_id_assignments": [
        "112234",
        "112235"
      ]
    }
  ],
  "page": {
    "total": 2,
    "limit": 1000,
    "offset": 0
  }
}

200 OK (include_validation=true)

{
  "organizations": [
    {
      "id": 1,
      "status": "active",
      "name": "DigiCert Inc.",
      "display_name": "DigiCert Inc.",
      "is_active": true,
      "address": "2801 N Thanksgiving Way",
      "address2": "Suite 500",
      "zip": "84043",
      "city": "Lehi",
      "state": "Utah",
      "country": "us",
      "container": {
        "id": 4,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      }
    },
    {
      "id": 112233,
      "status": "active",
      "name": "Example Organization Inc.",
      "assumed_name": "Example Org",
      "display_name": "Example Organization",
      "is_active": true,
      "address": "123 Fake Stree",
      "address2": "Floor 55",
      "zip": "84043",
      "city": "Lehi",
      "state": "ut",
      "country": "us",
      "telephone": "801-701-9600",
      "container": {
        "id": 4,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      },
      "validations": [
        {
          "type": "ov",
          "name": "OV",
          "description": "Normal Organization Validation",
          "date_created": "2018-10-09T19:29:02+00:00",
          "validated_until": "2019-11-09T20:28:55+00:00",
          "status": "active"
        },
        {
          "type": "ev",
          "name": "EV",
          "description": "Extended Organization Validation (EV)",
          "status": "pending"
        },
      ],
      "ev_approvers": [
        {
          "id": 184,
          "first_name": "Destinee",
          "last_name": "Church"
        }
      ],
      "container_id_assignments": [
        "112234",
        "112235"
      ]
    }
  ]
}

URL クエリー文字列

名前	申請/オプション	種別	説明
container_id	任意	int	結果を個別コンテナに対してフィルタリングします。
include_validation	任意	bool	組織の認証詳細を返すかどうかを指定します。デフォルト:`false`
limit	任意	int	ページネーション用にリストを指定番号に切り捨てます。最大:`1000`（デフォルト）
offset	任意	int	ページネーション用にリストを指定番号からはじめます。デフォルト:`0`

応答パラメータ

名前	種別	説明
organizations	array	申請で返されたすべての組織のリスト
.. id	int	組織 ID.
.. status	string	組織ステータス可能な値:`active`,`inactive`
.. name	string	組織の法人名
.. assumed_name	string	組織の公称別称 DBA 名
.. display_name	string	組織のフルネーム名前 + assumed_nameを使用して構築
.. is_active	bool	組織のアクティブステータス
.. address	string	組織の住所
.. address2	文字列
.. zip	string	組織所在地の郵便番号
.. city	string	組織の所在市町村
.. state	string	組織の所在州（都道府県）
.. country	string	組織の国
.. container	object	組織情報を添付する先のプライマリコンテナ
.. .. id	int	コンテナ ID
.. .. parent_id	int	コンテナの親の ID
.. .. name	string	コンテナ名
.. .. is_active	bool	コンテナのアクティブステータス
.. validations	array	組織が使用できる認証タイプ URL 照会の場合のみ返す `include_validation=true`.
.. ev_approvers	array	EV とコード署名オーダーを承認できるユーザーのリスト URL 照会の場合のみ返す `include_validation=true`.
.. extended validation	object	組織についての拡張認証情報 URL 照会の場合のみ返す `include_validation=true`.
.. container_id_assignments	array	組織を添付する先のコンテナのリスト
ページ	object	結果についての詳細 URL クエリ文字列を使用して修正済

URL クエリー文字列

応答パラメータ

案内