Dizin kullanıcısını alma

GET /v1/directories/{directory_id}/users/{directory_user_id} · izin directories:read

Dizinin canlı bir kullanıcı kaydını, Dizin kullanıcılarını listeleme ile aynı alanlarla döndürür. users:read_pii izni olmadan kişisel veriler aynı şekilde maskelenir ve attributes değeri null olur.

İstek

Alan	Tür	Zorunlu	Açıklama
`directory_id`	path	evet	SCIM dizin kimliği (`dir_…`).
`directory_user_id`	path	evet	Dizin kullanıcı kimliği (`dsu_…`).

İstek gövdesi yok.

Yanıt

Dizin kullanıcısıyla birlikte 200 OK döner.

{
  "id": "dsu_01j9xp4q6r8s0t2v4w6x8y0z2b",
  "directory_id": "dir_01j9xm2n4p6q8r0s2t4v6w8y0z",
  "external_id": "00u1a2b3c4",
  "user_name": "j***",
  "emails": [{ "value": "j***@e***.com", "primary": true }],
  "given_name": "J.",
  "family_name": "D.",
  "display_name": "J. D.",
  "locale": "en-US",
  "zoneinfo": "Europe/Berlin",
  "state": "inactive",
  "attributes": null,
  "groups": [],
  "user_id": null,
  "link_status": "unlinked",
  "drift": false,
  "created_at": "2026-10-20T09:00:00Z",
  "updated_at": "2026-10-20T09:05:00Z"
}

Örnek, users:read_pii izni olmayan bir kimlik bilgisine verilen yanıtı gösterir.

Hatalar

HTTP	code	Ne zaman
404	`not_found`	Dizin veya kullanıcı kaydı bu ortamda yok, başka bir dizine ait veya silinmiş.
401	`unauthenticated`	Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403	`insufficient_permissions`	Kimlik bilgisi gerekli izne sahip değil.
429	`rate_limited`	Hız sınırı aşıldı; `Retry-After` süresinden sonra tekrar deneyin.
503	`service_unavailable`	Dizin senkronizasyonu geçici olarak kullanılamıyor veya bu dağıtımda yapılandırılmamış; `Retry-After` süresinden sonra tekrar deneyin.

Örnek

curl -i "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/users/dsu_01j9xp4q6r8s0t2v4w6x8y0z2b" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Kişisel veriler

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