Kullanıcının e-posta adreslerini listeleme

GET /v1/users/{user_id}/emails · izin users:read

Kullanıcının tüm e-posta adreslerini tek bir sayfada listeler: önce birincil adres, ardından oluşturulma zamanına göre. Bir kullanıcının en fazla 10 adresi olabilir (birincil adres dahil), bu nedenle listenin limit, after, before ya da order parametresi yoktur ve list_metadata her zaman null değerlidir. id, e-posta kaydının iç UUID değeridir ve diğer e-posta uç noktaları tarafından kullanılır.

İstek

Parametre Konum Zorunlu Açıklama
user_id path evet Kullanıcı kimliği, usr_ önekiyle.

İstek gövde almaz (boş gövde ya da {} kabul edilir).

Yanıt

200 OK. users:read_pii izni olmadan adres maskelenir (a***@e***.com).

{
  "data": [
    {
      "id": "0191f0a0-3333-7444-8555-666666666661",
      "email": "ada@example.com",
      "verified": true,
      "primary": true,
      "created_at": "2026-01-15T09:30:00Z"
    },
    {
      "id": "0191f0a0-3333-7444-8555-666666666666",
      "email": "ada.work@example.com",
      "verified": false,
      "primary": false,
      "created_at": "2026-02-01T08:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Hatalar

Her hata, kararlı bir code içeren bir application/problem+json gövdesidir.

HTTP code Ne zaman
404 not_found Kullanıcı bu ortamda yok, siliniyor ya da kimlik hatalı biçimlendirilmiş.
401 unauthenticated API anahtarı eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Anahtarda users:read izni yok.
429 rate_limited Hız sınırı aşıldı; Retry-After değerine uyun.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin.

Örnek

curl https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/emails \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Kişisel veriler

Bu uç nokta kişisel veri içerir: son kullanıcı profili. KeenAuth API'lerinde kişisel veriler saklanan verileri, ne kadar süreyle tutulduklarını ve nasıl silindiklerini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.