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.
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) |