列出網域

GET
https://www.digicert.com/services/v2/domain

使用此端點列出您帳戶中的所有網域。

cURL
curl -X GET \
  'https://www.digicert.com/services/v2/domain?include_validation=true' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
Python
import requests

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

querystring = {"include_validation":"true"}

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

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

print(response.text)
Go
package main

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

func main() {

	url := "https://www.digicert.com/services/v2/domain?include_validation=true"

	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/domain',
  qs: { include_validation: 'true' },
  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
{
  "domains": [
    {
      "id": 2,
      "is_active": true,
      "name": "underlier-stanislavsky.org",
      "date_created": "2018-11-08T23:38:02+00:00",
      "organization": {
        "id": 516680,
        "status": "active",
        "name": "Example Company, Inc.",
        "display_name": "Example Company, Inc.",
        "is_active": "1"
      },
      "validations": [
         {
              "type": "ev",
              "name": "EV",
              "description": "Extended Organization Validation (EV)",
              "date_created": "2020-03-11T23:51:24+00:00",
              "validated_until": "2021-04-11T06:00:00+00:00",
              "status": "active"
         },
         {
              "type": "ov",
              "name": "OV",
              "description": "Normal Organization Validation",
              "date_created": "2020-03-11T23:51:24+00:00",
              "validated_until": "2022-06-14T06:00:00+00:00",
              "status": "active"
          }
      ],
      "dcv_method": "email",
      "dcv_expiration": {
          "ov": "2021-01-01T23:59:59+00:00"
          "ev": "2020-01-01T23:59:59+00:00"
       },   
      "container": {
        "id": 93288,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      }
    },
    {
      "id": 1,
      "is_active": true,
      "name": "entitative-absurdly.org",
      "date_created": "2018-11-01T17:44:31+00:00",
      "organization": {
        "id": 516681,
        "status": "active",
        "name": "Lackadaisically Fumiest Inc.",
        "assumed_name": "Lackadaisically Fumiest",
        "display_name": "Lackadaisically Fumiest Inc. (Lackadaisically Fumiest)",
        "is_active": "1"
      },
      "validations": [
         {
              "type": "ev",
              "name": "EV",
              "description": "Extended Organization Validation (EV)",
              "date_created": "2020-03-11T23:51:24+00:00",
              "validated_until": "2021-04-11T06:00:00+00:00",
              "status": "active"
         },
         {
              "type": "ov",
              "name": "OV",
              "description": "Normal Organization Validation",
              "date_created": "2020-03-11T23:51:24+00:00",
              "validated_until": "2022-06-14T06:00:00+00:00",
              "status": "active"
          }
      ],
      "dcv_method": "email",
      "dcv_expiration": {
          "ov": "2021-01-01T23:59:59+00:00"
          "ev": "2020-01-01T23:59:59+00:00"
       },   
      "container": {
        "id": 93288,
        "parent_id": 0,
        "name": "DigiCert Inc.",
        "is_active": true
      }
    }
  ],
  "page": {
    "total": 2,
    "limit": 1000,
    "offset": 0
  }
}

URL 查詢字串

名稱 必填/選填 類型 說明
container_id 選填 int 列出指派給指定容器的網域。
include_validation 選填 bool 如果是 true,請納入驗證資訊。
預設:false
limit 選填 int 將清單裁剪為指定頁數。
最大:1000 (預設)
offset 選填 int 在指定頁數開始清單。
預設:0

回應參數

名稱 類型 說明
domains array 由要求傳回的網域的清單。
.. id int 網域 ID。
.. is_active bool 網域的啟用狀態。
.. status string 網域的驗證狀態。
.. name string 網域的名稱。
.. date_created string 新增網域時的時間戳記。
格式:UTC 時區和 ISO 8601 日期
.. organization object 附加到網域的組織。
.. .. id int 組織 ID。
.. .. status string 組織的驗證狀態。
.. .. name string 組織的法律名稱。
.. .. assumed_name string 組織的公用名稱。
也稱為 DBA 名稱。
.. .. display_name string 組織的完整名稱。
使用名稱 + assumed_name 建構。
.. is_active string 組織的啟用狀態。
.. validations array 網域的驗證類型的清單。
僅傳回 if URL 查詢 include_validation=true
請參閱結構 — 驗證物件
.. dcv_method string 設定用於網域的網域控制驗證方法。
請參閱詞彙 — DCV 方法
.. dcv_expiration string 如果已完成 DCV,傳回此物件並包含與驗證到期時有關的資訊。
僅傳回 if URL 查詢 include_validation=true
.. .. ov string 驗證到期時的時間戳記。
格式:UTC 時區和 ISO 8601 日期
.. .. ev string 驗證到期時的時間戳記。
格式:UTC 時區和 ISO 8601 日期
.. dcv_token object 如果 DCV 方法使用隨機值權杖,此物件會傳回並包含權杖資訊。
.. .. token string 用於證明有網域的控制權的隨機值。
.. .. status string 網域驗證程序的狀態。
.. .. expiration_date string 權杖到期時的時間戳記。
格式:UTC 時區和 ISO 8601 日期
.. container object 附加網域的容器。
.. .. id int 容器 ID。
.. .. parent_id int 容器的父項的 ID。
.. .. name string 容器的名稱。
.. .. is_active bool 容器的啟用狀態。
頁面 object 與結果有關的詳細資料。
使用 URL 查詢字串修改。