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.
- Durée
- 10 min
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
- Votre serveur détient le jeton d'accès Keycloak de l'utilisateur (voir Intégrer la connexion dans une application serveur).
- L'utilisateur a accès à l'application dans cet environnement, avec un profil attribué (voir Droits et profils).
Appeler /api/me
Envoyez le jeton d'accès Keycloak en Authorization :
curl -s https://api.wakastart.app/api/me \
-H "Authorization: Bearer $ACCESS_TOKEN"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 :
{
"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
- 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é. - Utilisez les codes (
dossiers.update), jamais les libellés, qui peuvent changer. - Si la fiche n'a aucun profil dans cet environnement,
profilevaut{ "wid": "", "name": "Default" }sans droit : affichez une page qui l'invite à contacter son administrateur. - Pour rattacher l'utilisateur à vos propres données, utilisez le
subdu jeton ou l'adresse e-mail, pas lewid: il change d'un environnement à l'autre. Voir Adapter votre application aux fiches par environnement.
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 :
- Appelez
/api/mejuste après la connexion et stockez la réponse dans la session serveur. - 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.
- Ne stockez jamais la réponse dans
localStorage: elle décrit les droits de l'utilisateur.
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.