E-posta adreslerini listele

GET /fapi/v1/me/emails · ortamın giriş sunucusundan çağrılır

Kimliği doğrulanmış kullanıcının e-posta adreslerini döndürür; önce birincil adres, ardından eklenme zamanına göre sıralanır. Bir kullanıcı, birincil adres dahil en fazla 10 adres tutabilir. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezi gerekir; çerez eksik, süresi dolmuş veya iptal edilmişse 401 unauthenticated döner. Farklı bir kökenden çalışan birinci taraf bir uygulama bunun yerine Front API erişim belirtecini gönderebilir (Authorization: DPoP <token> ve bir DPoP kanıtı ile; bkz. Front API erişim belirteci).

İstek

Üstbilgiler:

Üstbilgi Zorunlu Açıklama
Idp-Client evet SDK tanımlayıcısı.
Origin evet Tam olarak https://<giriş sunucusu> olmalıdır.

Gövde yok.

Yanıt

200 OK:

Alan Tür Açıklama
data[].id string E-posta adresi tanımlayıcısı (küçük harfli UUID).
data[].email string Adres.
data[].verified boolean Kullanıcının adresin sahibi olduğunu kanıtlayıp kanıtlamadığı.
data[].primary boolean Adresin birincil adres olup olmadığı.
data[].created_at string Adresin eklenme zamanı (RFC 3339, UTC).
{
  "data": [
    {
      "id": "0190a5c4-1b2c-7d3e-8f40-516273849abc",
      "email": "ada@example.com",
      "verified": true,
      "primary": true,
      "created_at": "2026-10-01T09:30:00Z"
    }
  ]
}

Hatalar

Durum Kod Ne zaman
401 unauthenticated Geçerli bir oturum çerezi yok.
403 origin_not_allowed Origin eksik veya hatalı.

Örnek

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

Kişisel veriler

Bu uç nokta kişisel veri içerir: son kullanıcı profili. KeenAuth API'lerinde kişisel veriler sayfasında neyin saklandığı, ne kadar süre tutulduğu ve nasıl silindiği açıklanmaktadır. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.