ユーザーを一覧表示

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)

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 「用語集 — アクセスロール」を参照してください
.. .. name	string	アクセルロール名「用語集 — アクセスロール」を参照してください
.. 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 クエリ文字列を使用して修正済

URL クエリー文字列

応答パラメータ

案内