組織を一覧表示

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)
Go
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 クエリ文字列を使用して修正済