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

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

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