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.