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

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

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