# Profilinizi alın

`GET /fapi/v1/me` · ortamın giriş yap ana makinesinden çağrılır

Kimliği doğrulanmış kullanıcının kendi profilini döndürür: kullanıcının değiştirebildiği yedi alan ve `user_metadata`. İletişim bilgileri, doğrulama durumu, `app_metadata` ve yönetim alanları döndürülmez. `ETag` başlığı profil sürümüdür; bir değişikliği koşullu yapmak için bunu `If-Match` içinde gönderin. Kimliği doğrulanmış kullanıcının `__Host-idp_session` çerezi gereklidir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse `401 unauthenticated` döner. Farklı bir kökendeki birinci taraf bir uygulama bunun yerine ön yüz API erişim belirtecini gönderebilir (DPoP kanıtıyla birlikte `Authorization: DPoP <token>`; bkz. [Ön yüz API erişim belirteci](/docs/api/fapi/front-api-token)). Yakın zamanda yeniden doğrulama gerekmez. Yanıt kişisel veridir ve asla önbelleğe alınmaz.

## İstek

Başlıklar:

| Başlık | Zorunlu | Açıklama |
| --- | --- | --- |
| `Idp-Client` | evet | SDK tanımlayıcısı. |

Gövde yok.

## Yanıt

`ETag` başlığıyla birlikte `200 OK` (profil sürümü, örneğin `"8"`):

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `id` | string | Kullanıcı tanımlayıcısı (`usr_…`), belirteçlerdeki `sub` ile aynıdır. |
| `given_name` | string | Ad. |
| `family_name` | string | Soyad. |
| `name` | string | Tam ad. |
| `picture` | string | Resim URL'si (`https`). |
| `locale` | string | Dil (BCP 47 etiketi). |
| `zoneinfo` | string | Saat dilimi (IANA adı). |
| `username` | string | Kullanıcı adı. |
| `user_metadata` | object | Kullanıcının kendi meta verisi; her zaman bir JSON nesnesidir (boşsa `{}`). |

Değeri olmayan alanlar yanıtta yer almaz.

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

## Hatalar

| Durum | Kod | Ne zaman |
| --- | --- | --- |
| 401 | `unauthenticated` | Geçerli bir oturum çerezi yok. |
| 404 | `not_found` | Hesap okunamıyor (örneğin engellenmiş veya silinmekte). |
| 503 | `service_unavailable` | Kullanıcı dizini geçici olarak kullanılamıyor; `Retry-After` saniye sonra yeniden deneyin. |

## Örnek

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

## Kişisel veriler

Bu uç nokta kişisel veri içerir: son kullanıcı profili. [KeenAuth API'lerinde kişisel veriler](/docs/policies/personal-data), neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda kişisel verilerin özel kategorilerini (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.