Elenca utenti

GET

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

Usa questo endpoint per elencare tutti gli utenti account. I risultati possono essere filtrati in un contenitore specifico usando la stringa di query URL container_id.

Cambia l’intestazione ACCEPT con text/csv per avere un output CSV dei risultati.

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
  }
}

Stringhe di query URL

Nome	Rich/Opz	Tipo	Descrizione
container_id	facoltativo	int	Filtra risultati nel contenitore specifico.
offset	facoltativo	int	Avvia elenco nel numero specificato per la paginazione.
limit	facoltativo	int	Tronca elenco nel numero specificato per la paginazione.

Parametri di risposta

Nome	Tipo	Descrizione
users	array	Elenco di tutti gli utenti riportati dalla richiesta.
.. id	int	ID utente.
.. username	string	Stringa usata per l'accesso.
.. account_id	int	ID account CertCentral.
.. first_name	string	Nome utente.
.. last_name	string	Cognome utente.
.. email	string	Indirizzo e-mail utente.
.. job_title	string	Qualifica utente.
.. telephone	string	Numero di telefono utente.
.. status	string	Stato account utente. Consulta Glossario — Stato utente
.. container	object	Dettagli sul contenitore account principale.
.. .. id	int	ID del contenitore account principale.
.. .. public_id	string	ID pubblico per il contenitore account principale.
.. .. name	string	Nome del contenitore account principale.
.. .. parent_id	int	ID principale del contenitore account principale.
.. .. template_id	int	ID del modello utilizzato dal contenitore.
.. .. ekey	string	Chiave univoca usata per il branding personalizzato.
.. .. has_logo	bool	Stato del logo personalizzato per il contenitore.
.. .. is_active	bool	Stato attivo del contenitore.
.. access_roles	array	Dettagli sul ruolo accesso assegnato all’utente.
.. .. id	int	ID del ruolo di accesso. Consulta Glossario — Ruoli di accesso
.. .. name	string	Nome del ruolo di accesso. Consulta Glossario — Ruoli di accesso
.. type	string	Definisce il tipo di account utente.
.. has_container_assignments	bool	Stato di assegnazione contenitore. Se `true` riporta la matrice `container_assignments`.
.. container_assignments	array	Dettagli sulle assegnazioni del contenitore dell’utente.
.. .. id	int	ID del contenitore assegnato.
.. .. parent_id	int	ID del contenitore principale.
.. .. name	string	Nome del contenitore assegnato.
.. .. is_active	bool	Stato del contenitore assegnato.
pagina	object	Dettagli sui risultati. Modificati con le stringhe di query URL.

Stringhe di query URL

Parametri di risposta

Informazioni