Ajouter un utilisateur

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

Exécutez ce point de terminaison pour créer un utilisateur. Pour obtenir les rôles d’accès disponibles, appelez le point de terminaison List container roles (Répertorier les rôles de conteneur).

Par défaut, l’utilisateur sera créé dans le même conteneur que celui de l’utilisateur associé à la clé d’API utilisée dans la demande.

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
}

Paramètres de demande

Nom Obligatoire/facultatif Type Description
username Obligatoire string Nom d’utilisateur du profil
Caractères valides : a—z A—Z 0—9 @ - _ + .
first_name Obligatoire string Prénom de l’utilisateur
Limite de caractères : 128
last_name Obligatoire string Nom de l’utilisateur
Limite de caractères : 128
email Obligatoire string Adresse électronique de l’utilisateur
N’accepte que les adresses électroniques valides.
Limite de caractères : 255
job_title Facultatif string Intitulé de poste de l’utilisateur
Obligatoire si l’utilisateur doit être un approbateur EV.
Limite de caractères : 64
telephone Facultatif string Numéro de téléphone de l’utilisateur
Obligatoire si l’utilisateur doit être un approbateur EV.
Limite de caractères : 64
container Obligatoire object
.. id Obligatoire int ID du conteneur dans lequel l’utilisateur va être créé.
access_roles Obligatoire array
.. id Obligatoire int ID du rôle d’accès à attribuer à l’utilisateur.
Consultez le Glossaire — Rôles d’accès
container_id_assignments Obligatoire array Liste des ID de conteneur auxquels l’utilisateur va être affecté La définition de ce paramètre aura pour effet de remplacer tous les conteneurs par défaut visibles par l’utilisateur.

Paramètres de réponse

Nom Type Description
id int ID de l’utilisateur créé