Listar usuários

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

Use este ponto de extremidade para listar todos os usuários da conta. Resultados podem ser filtrados a um recipiente específico usando a string de consulta URL container_id.

Altere o cabeçalho ACCEPT para text/csv para retornar uma saída de CSV dos resultados.

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

Cadeias de consulta de URL

Nome Obr/Opc Tipo Descrição
container_id opcional int Filtre resultados ao recipiente específico.
offset opcional int Comece a lista no número especificado para paginação.
limit opcional int Trunque a lista ao número especificado para paginação.

Parâmetros da resposta

Nome Tipo Descrição
users array Lista de todos os usuários retornados pela solicitação.
.. id int ID de usuário.
.. username string String usada para fazer login.
.. account_id int ID da conta da CertCentral.
.. first_name string Nome do usuário.
.. last_name string Sobrenome do usuário.
.. email string Endereço de e-mail do usuário.
.. job_title string Cargo de trabalho do usuário.
.. telephone string Número de telefone do usuário.
.. status string Status da conta do usuário.
Consulte Glossário — Status do usuário
.. container object Detalhes sobre o recipiente primário da conta.
.. .. id int ID do recipiente primário da conta.
.. .. public_id string ID pública para o recipiente primário da conta.
.. .. name string Nome do recipiente primário da conta.
.. .. parent_id int ID do pai do recipiente primário da conta.
.. .. template_id int ID do modelo que o recipiente está usando.
.. .. ekey string Chave exclusiva usada para identidade visual da marca personalizada.
.. .. has_logo bool Status do logo personalizado para o recipiente.
.. .. is_active bool Status ativo do recipiente.
.. access_roles array Detalhes sobre a função de acesso atribuída do usuário.
.. .. id int ID da função de acesso.
Consulte Glossário — Funções de acesso
.. .. name string Nome da função de acesso.
Consulte Glossário — Funções de acesso
.. type string Define o tipo de conta do usuário.
.. has_container_assignments bool Status de atribuição do recipiente.
Se true retorna matriz container_assignments.
.. container_assignments array Detalhes sobre atribuições do recipiente do usuário
.. .. id int ID do recipiente atribuído.
.. .. parent_id int ID do recipiente pai.
.. .. name string Nome do recipiente atribuído.
.. .. is_active bool Status do recipiente atribuído.
página object Detalhes sobre resultados.
Modificado usando cadeias de consulta URL.