Users
Ce endpoint est dédié aux utilisateurs de Cards.
Listing des utilisateurs
GET https://api.cards-microlearning.com/v1/users
Récupération d'une liste d'utilisateurs.
Cette liste peut être filtrée et est paginée.
Entête (Headers)
Nom | Valeur |
---|---|
Content-Type |
|
Authorization |
|
X-Tenant |
|
Paramètre de l'url
Nom | Type | Description | Valeurs |
---|---|---|---|
| Nombre entier | Nombre d'élément dans la liste par page | Défaut : 100 Max : 500 |
| Tableau Json | Permet de filtrer sur un rôle, identifiant ou nom du groupe. Chaque entrée dans le tableau correspond à un filtre "AND". Chaque entrée doit avoir 2 clés :
La clé "values" peut être une chaine ou un tableau de valeurs (filtre "OR"). Format : [ { "type": "role", "values":"users" }, { "type": "groups_name", "values":"RPS" }, { "type": "groups_name", "values":["vol","sin"] }, { "type": "groups_id", "values":"9c445054-c2f0-46c4-b784-ae6ea4c3ebbe" } ] |
Réponse
Récupérer un utilisateur par son identifiant
GET https://api.cards-microlearning.com/v1/users/<id_utilisateur>
Récupérer les information d'un seul utilisateur
Entête (Headers)
Name | Value |
---|---|
Content-Type |
|
Authorization |
|
X-Tenant |
|
Réponse
Création d'un nouvel utilisateur
POST
https://api.cards-microlearning.com/v1/users
Créer un nouvel utilisateur sur Cards
Entête (Headers)
Name | Value |
---|---|
Content-Type |
|
Authorization |
|
X-Tenant |
|
Body
Les champs obligatoires sont :
firstname
lastname
email
Les contraintes appliquées aux valeurs sont :
firstname : longueur 190 charactères
lastname : longueur 190 charactères
company: firstname : longueur 190 charactères
lang : fr | en
source : app | sso | GoogleOAuth | MicrosoftOAuth | AppleOAuth
role : user | editor | owner
enable_ranking : 0 ou 1 (false ou true)
groups : Tableau de valeurs composé d'un ID et/ou d'un nom. Si l'ID est précisé, il est prioritaire sur le nom. Si le groupe n'existe pas et qu'un nom est donnée, le groupe sera créé automatiquement. Sinon le groupe sera ignoré.
Si tout se passe bien, l'objet de l'utilisateur créé sera renvoyé
Réponse
Mise à jour d'un utilisateur
PUT
https://api.cards-microlearning.com/v1/users/<id_utilisateur>
Mettre à jour les champs de son choix pour un utilisateur. Un champ non ajouté au BODY sera ignoré. Un champ vide en revanche supprimera la valeur du champ en question. Par exemple, si le champ "groups" est omis, les groupes actuelles seront gardés. Si "groups" est ajouté mais vide, tous les groupes pour cet utilisateurs seront retirés.
Entête (Headers)
Name | Value |
---|---|
Content-Type |
|
Authorization |
|
X-Tenant |
|
Body
Aucun champs n'est obligatoire.
Les contraintes appliquées aux valeurs sont :
firstname : longueur 190 charactères
lastname : longueur 190 charactères
company: firstname : longueur 190 charactères
lang : fr | en
source : app | sso | GoogleOAuth | MicrosoftOAuth | AppleOAuth
role : user | editor | owner
enable_ranking : 0 ou 1 (false ou true)
groups : Tableau de valeurs composé d'un ID et/ou d'un nom. Si l'ID est précisé, il est prioritaire sur le nom. Si le groupe n'existe pas et qu'un nom est donnée, le groupe sera créé automatiquement. Sinon le groupe sera ignoré.
Si tout se passe bien, l'objet de l'utilisateur créé sera renvoyé
Réponse
Suppression d'un utilisateur
DELETE
https://api.cards-microlearning.com/v1/users/<id_utilisateur>
Supprimer toutes les données d'un utilisateur (profile et parcours de formation).
Entête (Headers)
Name | Value |
---|---|
Content-Type |
|
Authorization |
|
X-Tenant |
|
Response
Dernière mise à jour