Aller au contenu

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.

GuideDéveloppeur
Durée
10 min
Voir en Markdown

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

Avant de commencer

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"
TypeScript
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 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.
TypeScript
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) : 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.
TypeScript
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.

Voir aussi