Benutzer hinzufügen

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

Verwenden Sie diesen Endpunkt, um einen neuen Benutzer zu einzurichten. Um verfügbare Zugriffsrollen zu erhalten, verwenden Sie den Endpunkt Containerrollen auflisten.

Standardmäßig wird ein Benutzer wird in demselben Container eingerichtet wie der Benutzer, der mit dem API-Schlüssel verknüpft ist, welcher für die Anfrage verwendet wird.

cURL
curl -X POST \
  https://www.digicert.com/services/v2/user \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "first_name": "Jill",
    "last_name": "Valentine",
    "email": "jill.valentine@pd.racoon-city.gov",
    "telephone": "555-555-5555",
    "job_title": "S.T.A.R.S. Alpha Team",
    "username": "jill.valentine",
    "container": {
        "id": 93288
    },
    "access_roles": [
        {
            "id": 5
        }
    ]
}'
Python
import requests

url = "https://www.digicert.com/services/v2/user"

payload = "{\n    \"first_name\": \"Jill\",\n    \"last_name\": \"Valentine\",\n    \"email\": \"jill.valentine@pd.racoon-city.gov\",\n    \"telephone\": \"555-555-5555\",\n    \"job_title\": \"S.T.A.R.S. Alpha Team\",\n    \"username\": \"jill.valentine\",\n    \"container\": {\n        \"id\": 93288\n    },\n    \"access_roles\": [\n        {\n            \"id\": 5\n        }\n    ]\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)
Go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/user"

	payload := strings.NewReader("{\n    \"first_name\": \"Jill\",\n    \"last_name\": \"Valentine\",\n    \"email\": \"jill.valentine@pd.racoon-city.gov\",\n    \"telephone\": \"555-555-5555\",\n    \"job_title\": \"S.T.A.R.S. Alpha Team\",\n    \"username\": \"jill.valentine\",\n    \"container\": {\n        \"id\": 93288\n    },\n    \"access_roles\": [\n        {\n            \"id\": 5\n        }\n    ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	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: 'POST',
  url: 'https://www.digicert.com/services/v2/user',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { first_name: 'Jill',
     last_name: 'Valentine',
     email: 'jill.valentine@pd.racoon-city.gov',
     telephone: '555-555-5555',
     job_title: 'S.T.A.R.S. Alpha Team',
     username: 'jill.valentine',
     container: { id: 93288 },
     access_roles: [ { id: 5 } ] },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
201 Created
{
    "id": 1538858
}

Antragsparameter

Name Antr./Opt. Typ Beschreibung
username erforderlich string Benutzername für das Profil.
Gültige Zeichen: a—z A—Z 0—9 @ - _ + .
first_name erforderlich string Vorname des Benutzers.
Maximallänge: 128
last_name erforderlich string Nachname des Benutzers.
Maximallänge: 128
email erforderlich string E-Mail-Adresse des Benutzers.
Akzeptiert nur gültige E-Mail-Adressen.
Maximallänge: 255
job_title optional string Funktion des Benutzers.
Erforderlich für einen EV-Genehmiger.
Maximallänge: 64
telephone optional string Telefonnummer des Benutzers.
Erforderlich für einen EV-Genehmiger.
Maximallänge: 64
container erforderlich object
.. id erforderlich int ID des Containers, unter dem der Benutzer eingerichtet wird.
access_roles erforderlich array
.. id erforderlich int ID der dem Benutzer zuzuweisenden Zugriffsrolle.
Siehe Glossar – Zugriffsrollen
container_id_assignments erforderlich array Liste der Container-IDs, denen der Benutzer zugewiesen wird. Falls eingetragen, werden alle standardmäßigen Container, die der Benutzer sehen kann, außer Kraft gesetzt.

Reaktionsparameter

Name Typ Beschreibung
id int ID des eingerichteten Benutzers.