網域資訊

GET

https://www.digicert.com/services/v2/domain/{{domain_id}}

使用此端點取得網域的詳細資料。

cURL

curl -X GET \
  'https://www.digicert.com/services/v2/domain/{{domain_id}}?include_dcv=true&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/{{domain_id}}"

querystring = {"include_dcv":"true","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)

package main

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

func main() {

	url := "https://www.digicert.com/services/v2/domain/{{domain_id}}?include_dcv=true&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/{{domain_id}}',
  qs: { include_dcv: 'true', 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

{
    "id": 76,
    "is_active": true,
    "status": "approved",
    "name": "overtorture-microspectrophotometry.org",
    "date_created": "2018-10-15T21:46:29+00:00",
    "organization": {
        "id": 112233,
        "status": "active",
        "name": "Palaeontography Enigmatic Corp.",
        "assumed_name": "Palaeontography Enigmatic",
        "display_name": "Palaeontography Enigmatic Corp. (Palaeontography Enigmatic)",
        "is_active": "1"
    },
    "validations": [
        {
            "type": "ev",
            "name": "EV",
            "description": "Extended Organization Validation (EV)",
            "date_created": "2018-10-15T21:46:41+00:00",
            "validated_until": "2019-11-15T22:46:37+00:00",
            "status": "active",
            "dcv_status": "complete",
            "org_status": "complete",
            "verified_users": [
                {
                    "id": 15,
                    "first_name": "Destinee",
                    "last_name": "Church",
                    "email": "destinee.church@outlook.com",
                    "job_title": "Landscape Architect",
                    "telephone": "101-656-8415"
                }
            ]
        },
        {
            "type": "ov",
            "name": "OV",
            "description": "Normal Organization Validation",
            "date_created": "2018-10-15T21:46:49+00:00",
            "validated_until": "2019-11-15T22:46:49+00:00",
            "status": "active",
            "dcv_status": "complete",
            "org_status": "complete"
        }
    ],
    "dcv_method": "email",
    "dcv_expiration": {
        "ov": "2021-01-01T23:59:59+00:00"
        "ev": "2020-01-01T23:59:59+00:00"
    },   
    "container": {
        "id": 4,
        "parent_id": 0,
        "name": "Container Name",
        "is_active": true
    }
}

URL 查詢字串

名稱	必填/選填	類型	說明
include_dcv	選填	bool	若為 `true` 請加入 DCV 資訊。預設：`false`
include_validation	選填	bool	如果是 `true`，請納入驗證資訊。預設：`false`

回應參數

名稱	類型	說明
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	設定用於網域的網域控制驗證方法。僅傳回 if URL 查詢 `include_validation=true`。請參閱詞彙 — DCV 方法
dcv_token	object	如果 DCV 方法使用隨機值權杖，此物件會傳回並包含權杖資訊。僅傳回 if URL 查詢 `include_validation=true`。
.. token	string	用於證明有網域的控制權的隨機值。
.. status	string	網域驗證程序的狀態。
.. expiration_date	string	權杖到期時的時間戳記。格式：UTC 時區和 ISO 8601 日期
dcv_expiration	object	如果已完成 DCV，傳回此物件並包含與驗證到期時有關的資訊。僅傳回 if URL 查詢 `include_validation=true`。
.. ov	string	驗證到期時的時間戳記。格式：UTC 時區和 ISO 8601 日期
.. ev	string	驗證到期時的時間戳記。格式：UTC 時區和 ISO 8601 日期
container	object	附加網域的容器。
.. id	int	容器 ID。
.. parent_id	int	容器的父項的 ID。
.. name	string	容器的名稱。
.. is_active	bool	容器的啟用狀態。

URL 查詢字串

回應參數

關於