사용자 목록

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 쿼리 문자열

응답 매개 변수

정보