Obtenir votre profil

GET /fapi/v1/me · appelé depuis l'hôte de connexion de l'environnement

Renvoie le profil de l'utilisateur authentifié : les sept champs que l'utilisateur peut modifier et user_metadata. Les coordonnées, l'état de vérification, app_metadata et les champs administratifs ne sont pas renvoyés. L'en-tête ETag correspond à la version du profil ; envoyez-le dans If-Match pour rendre une modification conditionnelle. Le cookie __Host-idp_session de l'utilisateur authentifié est requis ; si le cookie est absent, expiré ou révoqué, la réponse est 401 unauthenticated. Une application de première partie située sur une autre origine peut à la place envoyer son jeton d'accès à la Front API (Authorization: DPoP <token> avec une preuve DPoP ; voir Jeton d'accès Front API). Aucune nouvelle vérification récente n'est nécessaire. La réponse contient des données personnelles et n'est jamais mise en cache.

Requête

En-têtes :

En-tête Requis Description
Idp-Client oui Identifiant du SDK.

Aucun corps.

Réponse

200 OK avec un en-tête ETag (la version du profil, par exemple "8") :

Champ Type Description
id string Identifiant de l'utilisateur (usr_…), identique au sub des jetons.
given_name string Prénom.
family_name string Nom de famille.
name string Nom complet.
picture string URL de la photo (https).
locale string Langue (étiquette BCP 47).
zoneinfo string Fuseau horaire (nom IANA).
username string Nom d'utilisateur.
user_metadata object Les métadonnées propres à l'utilisateur ; toujours un objet JSON ({} lorsqu'il est vide).

Les champs sans valeur sont absents de la réponse.

{
  "id": "usr_01jbz6x8kq3m2n4p5r6s7t8v9w",
  "given_name": "Ada",
  "family_name": "Lovelace",
  "name": "Ada Lovelace",
  "locale": "en-GB",
  "zoneinfo": "Europe/London",
  "username": "ada",
  "user_metadata": {
    "theme": "dark"
  }
}

Erreurs

Statut Code Quand
401 unauthenticated Aucun cookie de session valide.
404 not_found Le compte ne peut pas être lu (par exemple bloqué ou en cours de suppression).
503 service_unavailable L'annuaire des utilisateurs est temporairement indisponible ; réessayez après Retry-After secondes.

Exemple

curl https://example.keenauth.app/fapi/v1/me \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

Données personnelles

Cet endpoint traite des données personnelles : profil de l'utilisateur final. Données personnelles dans les API KeenAuth décrit ce qui est stocké, pendant combien de temps et comment elles sont supprimées. N'envoyez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.