Kullanıcının bağlı kimliklerini listeleme

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

Kullanıcının bağlı kimliklerini (parola, sosyal, SAML, OIDC ve eski) oluşturulma zamanına göre sıralı, tek bir sayfada listeler. Kullanıcı başına kimlik sayısı sınırlı olduğundan listenin limit, after, before ya da order parametresi yoktur ve list_metadata her zaman null değerlidir. Bir kimliğin dış öznesi (OIDC sub, SAML NameID), kimlik sağlayıcının bildirdiği e-posta adresi ve kimlik bilgisi referansı hiçbir zaman döndürülmez. Passkey'ler ve tek kullanımlık kod yöntemleri kimlik doğrulayıcılardır ve GET /v1/users/{user_id}/authenticators ile listelenir.

İstek

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

Yanıt

200 OK. data, kimlikleri oluşturulma zamanına göre sıralı içerir; liste sayfalandırılmadığı için list_metadata her zaman null değerlidir. connection_id, password için null değerlidir; provider yalnızca social için ayarlanır.

Kimlik kimlikleri idn_ önekini taşır.

{
  "data": [
    {
      "id": "idn_0a1b2c3d4e5f6g7h8j9k0m1n2q",
      "type": "password",
      "connection_id": null,
      "provider": null,
      "linked_via": "primary",
      "created_at": "2026-01-15T09:30:00Z"
    },
    {
      "id": "idn_0a1b2c3d4e5f6g7h8j9k0m1n2r",
      "type": "social",
      "connection_id": "conn_0a1b2c3d4e5f6g7h8j9k0m1n2s",
      "provider": "google",
      "linked_via": "manual_link",
      "created_at": "2026-02-01T08:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

type: password, social, saml, oidc, legacy · linked_via: primary, auto_verified_email, user_confirmed, admin_api, import, jit, auto_domain, invite_proof, manual_link, scim_match

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 (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/identities \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Kişisel veriler

Bu uç nokta kişisel veri içerir: bağlı kimlikler. 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.