# Charger le contexte utilisateur

> Lire l'identité, l'organisation, le profil et les droits de l'utilisateur connecté avec GET /api/me, et mettre la réponse en cache dans la session.

`GET /api/me` est la source de vérité de votre application sur l'utilisateur connecté : qui il est, à quel client il appartient, et quels droits son profil lui donne **dans l'environnement de la session**. Ce guide montre comment l'appeler, quoi en lire et comment le mettre en cache.

`/api/me` décrit la fiche de l'utilisateur **dans l'environnement de la session**, déduit du jeton : il ne prend aucun paramètre d'environnement. Une même personne a une fiche distincte, avec son propre WID, dans chaque environnement où elle existe (voir [Comptes et environnements](/v1.0/utilisateurs/comptes-et-environnements)).

## Avant de commencer

- Votre serveur détient le jeton d'accès Keycloak de l'utilisateur (voir [Intégrer la connexion dans une application serveur](/v1.0/authentification/integrer-la-connexion-application-serveur)).
- L'utilisateur a accès à l'application dans cet environnement, avec un profil attribué (voir [Droits et profils](/v1.0/droits-et-profils)).

## Appeler /api/me

Envoyez le jeton d'accès Keycloak en `Authorization` :

```bash
curl -s https://api.wakastart.app/api/me \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

```ts
export interface Me {
  wid: string;
  email: string;
  firstName?: string;
  lastName?: string;
  isActive: boolean;
  adminLevel: string;
  hdsRoles: string[];
  partner?: { wid: string; name: string };
  network?: { wid: string; name: string };
  customer: { wid: string; name: string };
  teams: { wid: string; name: string; teamLevel: string }[];
  profile: {
    wid: string;
    name: string;
    description?: string;
    rights?: { code: string; name: string; description?: string; category?: string }[];
  };
  branding: Record<string, unknown>;
  lastLoginAt?: string;
  createdAt: string;
}

export async function fetchMe(accessToken: string): Promise<Me> {
  const response = await fetch("https://api.wakastart.app/api/me", {
    headers: { Authorization: `Bearer ${accessToken}` },
  });
  if (!response.ok) throw new Error(`/api/me a répondu ${response.status}`);
  return (await response.json()) as Me;
}
```

Réponse attendue :

```json
{
  "wid": "EXUSR1",
  "email": "claire.martin@exemple.fr",
  "firstName": "Claire",
  "lastName": "Martin",
  "isActive": true,
  "adminLevel": "USER",
  "hdsRoles": [],
  "partner": { "wid": "EXPAR1", "name": "Éditeur Exemple" },
  "network": { "wid": "EXNET1", "name": "Réseau Exemple" },
  "customer": { "wid": "EXCLI1", "name": "Clinique Exemple" },
  "teams": [],
  "profile": {
    "wid": "EXPRF1",
    "name": "Soignant",
    "description": "Consultation et mise à jour des dossiers",
    "rights": [
      { "code": "dossiers.read", "name": "Lire les dossiers", "category": "Dossiers" },
      { "code": "dossiers.update", "name": "Modifier les dossiers", "category": "Dossiers" }
    ]
  },
  "branding": {
    "logoLightUrl": "https://cdn.exemple.fr/logo-clair.png",
    "primaryColor": "#0f766e",
    "themeName": "default"
  },
  "lastLoginAt": "2026-10-23T09:12:44.000Z",
  "createdAt": "2026-09-02T14:05:10.000Z"
}
```

Si votre serveur détient déjà un jeton enrichi, vous pouvez l'envoyer à la place, dans l'en-tête `x-enriched-token`.

## Lire les droits

1. Lisez `profile.rights` : c'est la liste des [droits applicatifs](/v1.0/glossaire#droit-applicatif) du profil de l'utilisateur pour l'environnement de la session. Un droit absent de la liste est refusé.
2. Utilisez les codes (`dossiers.update`), jamais les libellés, qui peuvent changer.
3. Si la fiche n'a aucun profil dans cet environnement, `profile` vaut `{ "wid": "", "name": "Default" }` sans droit : affichez une page qui l'invite à contacter son administrateur.
4. Pour rattacher l'utilisateur à vos propres données, utilisez le `sub` du jeton ou l'adresse e-mail, pas le `wid` : il change d'un environnement à l'autre. Voir [Adapter votre application aux fiches par environnement](/v1.0/utilisateurs/adapter-votre-application-aux-fiches-par-environnement).

```ts
export const can = (me: Me, code: string) =>
  me.profile.rights?.some((right) => right.code === code) ?? false;
```

## Mettre la réponse en cache

`/api/me` n'est pas mis en cache côté API : chaque appel relit les droits. Pour limiter les appels :

1. Appelez `/api/me` juste après la connexion et stockez la réponse dans la session serveur.
2. Rechargez-la après chaque rafraîchissement de session (voir [Rafraîchir la session](/v1.0/authentification/rafraichir-la-session)) : un changement de profil est pris en compte par Wakastart en une minute au plus.
3. Ne stockez jamais la réponse dans `localStorage` : elle décrit les droits de l'utilisateur.

```ts
const ME_TTL_MS = 5 * 60 * 1000;

export async function getMe(session: { accessToken: string; me?: Me; meFetchedAt?: number }) {
  if (session.me && Date.now() - (session.meFetchedAt ?? 0) < ME_TTL_MS) return session.me;
  session.me = await fetchMe(session.accessToken);
  session.meFetchedAt = Date.now();
  return session.me;
}
```

## Vérifier le résultat

Connectez-vous avec un compte de test, puis retirez-lui un droit depuis la console. Après un rafraîchissement de session, `profile.rights` ne contient plus ce droit.

## Dépannage

- `401` « Authentification requise: Bearer token (Authorization header) ou cle API (x-api-key header) » : jeton expiré, ou utilisateur sans fiche ni accès à l'application dans cet environnement.
- `401` « Environment cannot be deduced: session has no environment » : le jeton ne porte pas d'environnement ; reconnectez l'utilisateur. Wakastart ne se replie pas sur la production.
- `404` « Utilisateur non trouvé » : le compte Keycloak n'est rattaché à aucun utilisateur Wakastart.
- `409` « Impossible de résoudre l'utilisateur de façon unique (customerId manquant ou invalide) » : le compte appartient à plusieurs clients et le jeton ne permet pas de choisir.

Voir [Résoudre les problèmes de connexion](/v1.0/authentification/depannage).

## Voir aussi

- [Jeton enrichi et /me](/v1.0/concepts/jeton-enrichi-et-me).
- [Référence : réponse de /api/me](/v1.0/authentification/reference#réponse-de-apime).
- [Référence API : Jeton et /me](/v1.0/reference-api/jeton-et-me).
