DigiCert® ONE 是一款現代的 PKI 平台，為快速和彈性 PKI 部署提供可擴充的基礎。DigiCert ONE API 提供管理您的憑證和裝置、自訂和自動化工作流程、以及整合 DigiCert ONE 與您現有的 PKI 管理工具的強大介面。
DigiCert ONE 包括在這些主控台中找到的管理活動的 API：
在您可以使用 DigiCert ONE API 前，您需要：
若要建立新的 API 密鑰：
每個 API 密鑰僅顯示一次。沒有擷取遺失的 API 密鑰的方式。如果您曾遺失 API 密鑰，您需要撤銷遺失的密鑰，然後產生一個新的。
DigiCert ONE API 使用標頭形式的身份驗證。每個要求都包括自訂的 HTTP 標頭 x‑api‑key。當您提交您的要求時，使用您自己的 API 密鑰作為此標頭的值。
例如，以下是對建立新裝置的端點的要求。
curl -X POST \
'https://one.digicert.com/iot/api/v1/device' \
-H 'x-api-key: {{api_key}}' \
-H 'Content-Type: application/json' \
-d '{
"division_id": {{division_id}},
"device_identifier": "MyDevice",
"device_profile_id": {{device_profile_id}}
}'import requests
url = "https://stage.one.digicert.com/iot/api/v1/device"
payload = "{\n \"division_id\": {{division_id}},\n \"device_identifier\": \"MyDevice\",\n \"device_profile_id\": {{device_profile_id}}\n}"
headers = {
'x-api-key': {{api_key}},
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data = payload)
print(response.text.encode('utf8'))package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://stage.one.digicert.com/iot/api/v1/device"
method := "POST"
payload := strings.NewReader("{\n \"division_id\": {{division_id}},\n \"device_identifier\": \"MyDevice\",\n \"device_profile_id\": {{device_profile_id}}\n}")
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
}
req.Header.Add("x-api-key", {{api_key}})
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
fmt.Println(string(body))
}var request = require('request');
var options = {
'method': 'POST',
'url': 'https://stage.one.digicert.com/iot/api/v1/device',
'headers': {
'x-api-key': {{api_key}},
'Content-Type': 'application/json'
},
body: "{\n \"division_id\": {{division_id}},\n \"device_identifier\": \"MyDevice\",\n \"device_profile_id\": {{device_profile_id}}\n}"
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});使用此基礎 URL 建構 DigiCert ONE API：
https://one.digicert.com有些端點使用 URL 查詢字串篩選結果。若要附加查詢字串到端點 URL，請使用 ?.若要附加其他查詢字串，請使用 &。
此範例使用 division_id 查詢字串篩選到指定分部的結果。
https://one.digicert.com/iot/api/v1/device/{{device_identifier}}?division_id={{division_id}}所有 API 要求都使用 REST 功能透過 RESTful URL 提交，包括標頭形式的身份驗證和 JSON 要求類型。
要求的資料字元集編碼是 UTF-8。語式正確的要求使用連接埠 443，而且有指定的使用者代理程式和內容長度 HTTP 標頭。
DigiCert ONE API 使用標準 HTTP 方法，包括：
GETPOSTPUTDELETE除非另有註明，否則大多數要求需要通過 JSON 或 XML 格式的資料。Content-Type 標題的支援值包括：
application/json回應由標頭和內文組成。回應本文的格式視您在要求中指定的內容類型而定。
如需更多有關個別 HTTP 標頭回應代碼的資訊，請參閱詞彙 – 標頭。