Bir kuruluşun üyelerini listele

GET /fapi/v1/organizations/{org_id}/memberships · ortamın oturum açma ana bilgisayarından çağrılır

Bir kuruluşun üyeliklerini, son değişikliğe göre sıralanmış olarak listeler; bir kuruluş profili ekranı için kullanılır. Bekleyen davetler burada görünmez. Her satır kullanıcıyı yalnızca usr_… tanımlayıcısıyla belirtir; bu uç nokta ad veya e-posta adresi döndürmez. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezi gerekir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse 401 unauthenticated döner. Farklı bir kökenden gelen birinci taraf bir uygulama bunun yerine ön uç API erişim belirtecini gönderebilir (Authorization: DPoP <token> ve bir DPoP kanıtı ile; bkz. Ön uç API erişim belirteci). Kullanıcının kuruluşun etkin bir üyesi olması ve idp_members:read iznine sahip olması gerekir. Üye olmayan bir kullanıcı 404 not_found alır; izni olmayan bir üye 403 insufficient_permissions alır.

@keenauth/js ile: await keenauth.organizations.members(orgId, { status: "active" }).

İstek

Üstbilgiler:

Üstbilgi Zorunlu Açıklama
Idp-Client evet SDK tanımlayıcısı.

org_id: kuruluş tanımlayıcısı (org_…).

Sorgu parametreleri:

Parametre Zorunlu Açıklama
status hayır active, suspended veya removed; atlandığında üçü de.
role_id hayır Yalnızca bu rolü (rol_…) taşıyan üyelikler.
after hayır Önceki sayfanın next_after değeri (opak).
limit hayır 1–100, varsayılan 20.

Gövde yok.

Yanıt

200 OK ile {"data": [...], "next_after": "..."}; next_after son sayfada bulunmaz.

Her öğe: id (mem_…), user_id (usr_…), status, roles (her biri role_id ve atamanın nereden geldiğini gösteren source ile birlikte, örneğin admin_api veya default), created_at, activated_at (veya null), expires_at (veya null), updated_at, version.

Hatalar

Durum Kod Ne zaman
400 invalid_cursor after hatalı biçimlendirilmişse.
401 unauthenticated Geçerli bir oturum çerezi yoksa.
403 insufficient_permissions Kullanıcının kuruluşta idp_members:read izni yoksa.
404 not_found Bu kullanıcı için böyle bir kuruluş yoksa; bilinmeyen, hatalı biçimlendirilmiş veya başkasına ait tanımlayıcı aynı yanıtı verir.
422 validation_failed status, role_id veya limit geçersizse.
503 service_unavailable Geçici olarak kullanılamıyor; Retry-After değerinden sonra yeniden deneyin.

Örnek

curl "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/memberships?status=active&limit=2" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

{
  "data": [
    {
      "id": "mem_01jbz6x8kq3m2n4p5r6s7t8v9b",
      "user_id": "usr_01jbz6x8kq3m2n4p5r6s7t8v9c",
      "status": "active",
      "roles": [{ "role_id": "rol_01jbz6x8kq3m2n4p5r6s7t8v9w", "source": "admin_api" }],
      "created_at": "2026-11-03T09:00:00Z",
      "activated_at": "2026-11-03T09:00:00Z",
      "expires_at": null,
      "updated_at": "2026-11-03T09:00:00Z",
      "version": 1
    }
  ],
  "next_after": "AAAYQ3dAgGUBmgAAAABwAIAAAAAAAADh"
}

Kişisel veriler

Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. KeenAuth API'lerinde kişisel veriler sayfası neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini 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.