列出使用者

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

使用此端點列出所有帳戶使用者。使用 container_id URL 查詢字串將結果篩選至特定容器。

變更 ACCEPT 標題為 text/csv 以傳回 CSV 輸出的結果。

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

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

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/user"

    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/user',
  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
{
  "users": [
    {
      "id": 125038,
      "username": "jane.doe@digicert.com",
      "account_id": <account_id>,
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane.doe@digicert.com",
      "job_title": "Boss",
      "telephone": "555-555-5555",
      "status": "active",
      "container": {
        "id": 5,
        "public_id": "<public_id>",
        "name": "Company",
        "parent_id": 0,
        "template_id": 4,
        "ekey": "<ekey>",
        "has_logo": false,
        "is_active": true
      },
      "access_roles": [
        {
          "id": 1,
          "name": "Administrator"
        }
      ],
      "type": "standard",
      "has_container_assignments": false
    },
    {
      "id": 125039,
      "username": "john.smith@digicert.com",
      "account_id": <account_id>,
      "first_name": "John",
      "last_name": "Smith",
      "email": "john.smith@digicert.com",
      "job_title": "Employee",
      "telephone": "555-555-5555",
      "status": "active",
      "container": {
        "id": 5,
        "public_id": "<public_id>",
        "name": "Company",
        "parent_id": 0,
        "template_id": 4,
        "ekey": "<ekey>",
        "has_logo": false,
        "is_active": true
      },
      "access_roles": [
        {
          "id": 5,
          "name": "Standard User"
        }
      ],
      "type": "standard",
      "has_container_assignments": true,
      "container_assignments": [
        {
          "id": <container_id>,
          "parent_id": <parent_container_id>,
          "name": <container_name>,
          "is_active": true
      ]
    }
  ],
  "page": {
    "total": 2,
    "limit": 1000,
    "offset": 0
  }
}

URL 查詢字串

名稱 必填/選填 類型 說明
container_id 選填 int 篩選結果至指定容器。
offset 選填 int 在指定頁數開始清單。
limit 選填 int 將清單裁剪為指定頁數。

回應參數

名稱 類型 說明
users array 依要求傳回的所有使用者的清單。
.. id int 使用者 ID。
.. username string 用於登入的字串。
.. account_id int CertCentral 帳戶 ID。
.. first_name string 使用者名字。
.. last_name string 使用者姓氏。
.. email string 搜尋電郵地址。
.. job_title string 使用者職稱。
.. telephone string 使用者電話號碼。
.. status string 使用者帳戶狀態。
請參閱詞彙 — 使用者狀態
.. container object 與主要帳戶容器有關的詳細資料。
.. .. id int 主要帳戶容器的 ID。
.. .. public_id string 主要帳戶容器的公用 ID。
.. .. name string 主要帳戶容器的名稱。
.. .. parent_id int 主要帳戶容器的父項 ID。
.. .. template_id int 容器使用的範本的 ID。
.. .. ekey string 用於自訂品牌的唯一金鑰。
.. .. has_logo bool 容器的自訂標誌狀態。
.. .. is_active bool 容器的啟用狀態。
.. access_roles array 與指派給使用者的存取角色有關的詳細資料。
.. .. id int 存取角色的 ID。
請參閱詞彙 — API 存取角色
.. .. name string 存取角色的名稱。
請參閱詞彙 — API 存取角色
.. type string 定義使用者帳戶類型。
.. has_container_assignments bool 容器指派狀態。
是否 true 傳回 container_assignments 陣列。
.. container_assignments array 與使用者的容器指派有關的詳細資料。
.. .. id int 指派的容器的 ID。
.. .. parent_id int 父項容器的 ID。
.. .. name string 指派的容器的名稱。
.. .. is_active bool 指派的容器的狀態。
頁面 object 與結果有關的詳細資料。
使用 URL 查詢字串修改。