# Leggi il tuo profilo

`GET /fapi/v1/me` · chiamato dall'host di accesso dell'ambiente

Restituisce il profilo proprio dell'utente autenticato: i sette campi che l'utente può modificare e `user_metadata`. Dettagli di contatto, stato di verifica, `app_metadata` e campi amministrativi non vengono restituiti. L'intestazione `ETag` è la versione del profilo; inviala in `If-Match` per rendere condizionata una modifica. Richiede il cookie `__Host-idp_session` dell'utente autenticato; se il cookie manca, è scaduto o revocato, restituisce `401 unauthenticated`. Un'app di prima parte su un'altra origine può invece inviare il proprio token di accesso alla Front API (`Authorization: DPoP <token>` con una prova DPoP; vedi [Token di accesso alla Front API](/docs/api/fapi/front-api-token)). Non è necessaria una nuova verifica recente. La risposta contiene dati personali e non viene mai memorizzata nella cache.

## Richiesta

Intestazioni:

| Intestazione | Obbligatoria | Descrizione |
| --- | --- | --- |
| `Idp-Client` | sì | Identificatore dell'SDK. |

Nessun corpo.

## Risposta

`200 OK` con un'intestazione `ETag` (la versione del profilo, per esempio `"8"`):

| Campo | Tipo | Descrizione |
| --- | --- | --- |
| `id` | stringa | Identificatore dell'utente (`usr_…`), uguale al `sub` dei token. |
| `given_name` | stringa | Nome. |
| `family_name` | stringa | Cognome. |
| `name` | stringa | Nome completo. |
| `picture` | stringa | URL dell'immagine (`https`). |
| `locale` | stringa | Lingua (tag BCP 47). |
| `zoneinfo` | stringa | Fuso orario (nome IANA). |
| `username` | stringa | Nome utente. |
| `user_metadata` | oggetto | I metadati propri dell'utente; è sempre un oggetto JSON (`{}` se vuoto). |

I campi senza valore non sono presenti nella risposta.

```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"
  }
}
```

## Errori

| Stato | Codice | Quando |
| --- | --- | --- |
| 401 | `unauthenticated` | Nessun cookie di sessione valido. |
| 404 | `not_found` | L'account non può essere letto (per esempio bloccato o in cancellazione). |
| 503 | `service_unavailable` | La directory degli utenti è temporaneamente non disponibile; riprova dopo `Retry-After` secondi. |

## Esempio

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

## Dati personali

Questo endpoint tratta dati personali: profilo dell'utente finale. [Dati personali nelle API di KeenAuth](/docs/policies/personal-data) descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.