列出組織

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 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 查詢字串修改。