# 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](/docs/api/fapi/front-api-token)). 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.

```json
{
  "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

```bash
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](/docs/policies/personal-data) 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.