列出組織

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	string
.. zip	string	組織的郵遞區號。
.. city	string	組織所位於的城市。
.. state	string	組織所位於的省。
.. country	string	組織的國家。
.. container	object	附加組織的主要容器。
.. .. id	int	容器 ID。
.. .. parent_id	int	容器的父項的 ID。
.. .. name	string	容器的名稱。
.. .. is_active	bool	容器的啟用狀態。
.. validations	array	組織可使用的驗證類型。僅傳回 if URL 查詢 `include_validation=true`。
.. ev_approvers	array	可以核准 EV 和代碼簽章訂單的使用者的清單。僅傳回 if URL 查詢 `include_validation=true`。
.. extended validation	object	與組織有關的延伸驗證資訊。僅傳回 if URL 查詢 `include_validation=true`。
.. container_id_assignments	array	指派組織所到的容器的清單。
頁面	object	與結果有關的詳細資料。使用 URL 查詢字串修改。

URL 查詢字串

回應參數

關於