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)

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.

Antragsparameter

Reaktionsparameter

Über