# 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](/v1.0/reference-api/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) |
