Kuruluşlarımı listele
GET /fapi/v1/me/organizations · ortamın oturum açma ana bilgisayarından çağrılır
Kimlik doğrulaması yapılmış kullanıcının bir uygulamada geçiş yapabileceği kuruluşları, sıralı olarak ve en fazla 100 kayıt olacak şekilde listeler. Listeye yalnızca kullanıcının etkin üyeliğinin bulunduğu, etkin olan ve uygulamanın etkinleştirildiği kuruluşlar dahil edilir. Bu, kuruluş değiştiricinin gösterdiği liste ve barındırılan kuruluş seçicinin oturum açma sırasında sunduğu listedir; dolayısıyla uygulamanın kullanamayacağı bir kuruluşu asla göstermez. Hiçbir öğe geçerli olarak işaretlenmez: uygulamanızın belirteci hangi kuruluşa bağlıysa bu, belirtecin org_id talebidir. Okuma işlemi hiçbir şeyi değiştirmez ve yakın zamanda doğrulanmış bir oturum gerektirmez. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezi gereklidir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse 401 unauthenticated döner.
@keenauth/js ile: await keenauth.organizations.listMine().
İstek
Başlıklar:
| Başlık | Zorunlu | Açıklama |
|---|---|---|
Idp-Client |
evet | SDK tanımlayıcısı. |
Sorgu parametreleri:
| Parametre | Zorunlu | Açıklama |
|---|---|---|
client_id |
evet | Kuruluş değiştiricinin çalıştığı birinci taraf uygulamanın client_id değeri. |
Gövde yoktur.
Yanıt
200 OK ile {"data": [...], "truncated": false} döner.
Her öğe: id (org_…, belirtecin org_id talebi ve organization parametresiyle aynı biçimde), slug, name (denetim ve çift yönlü karakterleri kaldırılmış görünen ad; kuruluşun adı yoksa slug. Düz metin olarak gösterin). Kullanıcının listelenenden daha fazla bu tür kuruluşu varsa truncated değeri true olur.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 401 | unauthenticated |
Geçerli bir oturum çerezi yok. |
| 403 | headless_not_allowed |
Uygulama üçüncü taraf bir uygulama. |
| 422 | validation_failed |
client_id eksik, boş, 255 karakterden uzun, birden fazla kez verilmiş veya bilinmiyor (/client_id). |
| 503 | temporarily_unavailable |
Üyelik dizini yanıt vermedi; daha sonra yeniden deneyin. |
Örnek
curl "https://example.keenauth.app/fapi/v1/me/organizations?client_id=app_01j9zzzzzzzzzzzzzzzzzzzz" \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
{
"data": [
{
"id": "org_01j9xxxxxxxxxxxxxxxxxxxxxx",
"slug": "acme",
"name": "Acme"
}
],
"truncated": false
}
Kişisel veriler
Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. KeenAuth API'lerinde kişisel veriler bölümünde neyin saklandığı, ne kadar süreyle 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.