Référence des droits et profils
Champs et limites des niveaux d'administration, droits applicatifs, profils et droits de profil, réponse de /api/me et opérations de l'API publique.
This page has not been translated yet and is shown in French.
Cette page décrit les objets du modèle de droits. Le détail de chaque endpoint est dans la référence API des droits et profils.
Niveau d'administration
| Valeur de l'API | Code de la console | Libellé de Mon profil |
|---|---|---|
PARTNER_ADMIN | OwnerAdmin | Administrateur Partenaire |
APP_ADMIN | AppsAdmin | Administrateur Applications |
NETWORK_ADMIN | NetworkAdmin | Administrateur Réseau |
CUSTOMER_ADMIN | CustomerAdmin | Administrateur Client |
USER | User | Utilisateur |
NONE | None | Aucun |
Claim du jeton enrichi : wadl.
Droit applicatif
| Champ | Libellé de la console | Type | Contraintes |
|---|---|---|---|
id | UUID | ||
appId | UUID | obligatoire à la création | |
code | Code | chaîne | 1 à 50 caractères, unique dans l'application, non modifiable |
name | Nom | chaîne | 100 caractères, obligatoire |
description | Description | chaîne | |
category | (API) | chaîne | 50 caractères |
isSystem | booléen | true : non modifiable, non supprimable |
200 droits au plus par application. Un droit existe dans les trois environnements ; le champ availableEnvs a disparu et il est ignoré s'il est encore envoyé.
Profil
| Champ | Libellé de la console | Type | Contraintes |
|---|---|---|---|
id | UUID | ||
wid | chaîne | 5 ou 6 caractères ; identifiant public, commun aux trois environnements | |
appId | UUID | obligatoire | |
networkId, customerId | UUID | renseignés seulement pour un ancien profil de réseau ou de client, historique ; ne se créent plus | |
name | Nom | chaîne | 100 caractères, obligatoire, unique dans l'application |
description | Description | chaîne | |
isActive | booléen | ||
isSystem | booléen | true : non modifiable, non supprimable |
Droit d'un profil
| Champ | Description |
|---|---|
appRightId | UUID du droit |
envType | Environnement de la matrice où le profil porte le droit ; c'est toujours celui de l'appelant, jamais fourni |
Un profil et un droit existent dans les trois environnements. Seule la matrice profils × droits est propre à chacun, sans copie ni promotion de l'un vers l'autre.
Masquage par réseau
Un profil d'application peut être masqué pour un réseau. Il n'est plus proposé aux clients de ce réseau ; les attributions existantes sont conservées.
Réponse de GET /api/me
| Champ | Type | Description |
|---|---|---|
wid, email, firstName, lastName | chaînes | Identité de la fiche de l'environnement de la session ; le wid est propre à cet environnement |
isActive | booléen | Statut |
adminLevel | chaîne | Niveau d'administration (valeur de l'API) |
hdsRoles | tableau | Rôles sur les données de santé |
partner, network, customer | { wid, name } | Organisation |
teams | [{ wid, name, teamLevel }] | Équipes |
profile | { wid, name, description, rights } | Profil de l'environnement de la session |
profile.rights | [{ code, name, description, category }] | Droits de ce profil dans la matrice de cet environnement |
branding | objet | Logos, couleurs et thème résolus pour l'utilisateur |
lastLoginAt, createdAt | dates |
Opérations de l'API publique
URL de base : https://api.wakastart.app/api. Toutes exigent le niveau Administrateur client au moins, sauf GET /me. Les profils se désignent par leur WID ({profile}), l'UUID restant accepté. Les opérations sur les droits et les utilisateurs d'un profil portent sur l'environnement de l'appelant ; env et envType y sont refusés en 400.
| Opération | Méthode et chemin | Droit |
|---|---|---|
| Lire son profil et ses droits | GET /me | aucun ; jeton émis pour l'application |
| Lister les droits | GET /config/app-rights, GET /config/app-rights/by-app/{appWid}, GET /config/app-rights/{id} | app-rights.read |
| Créer, modifier, supprimer un droit | POST /config/app-rights, PUT et DELETE /config/app-rights/{id} | app-rights.create, app-rights.update, app-rights.delete |
| Lister, consulter les profils | GET /config/profiles, GET /config/profiles/{profile} | profiles.read |
| Profils proposés à un client | GET /config/profiles/customer/{customerWid}/visible | profiles.read |
| Profils d'un réseau | GET /config/profiles/network/{networkWid}, GET /config/profiles/network/{networkWid}/available | profiles.read |
| Créer, modifier, supprimer un profil | POST /config/profiles, PUT et DELETE /config/profiles/{profile} | profiles.create, profiles.update, profiles.delete |
| Lire les droits d'un profil | GET /config/profiles/{profile}/rights | aucun (administrateur client) |
| Ajouter, retirer un droit | POST et DELETE /config/profiles/{profile}/rights/{rightId} | aucun (administrateur client) |
| Remplacer tous les droits | PUT /config/profiles/{profile}/rights | aucun (administrateur client) |
| Lister les utilisateurs d'un profil | GET /config/profiles/{profile}/users | aucun (administrateur client) |
| Attribuer, retirer un profil | POST et DELETE /config/profiles/{profile}/users/{userWid} | aucun (administrateur client) |