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

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.